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EDITOR'S COMMENTS 



Welcome to issue number 64, a big issue 
in many ways. There are many new items 
to discuss and lots of regulars as well. 

The newest member of The Computer 
Journal writing staff is Ronald Ander- 
son. His letter of introduction starts the 
Reader to Reader section. Ron comes 
fijom the 6809 world by way of the old 68 
Micro Journal. Many of our readers may 
remember him form his regular coliunn 
that appeared in that magazine. Since 
that time Ron has continued his 6809 
work while porting many of his Flex and 
OS-9 products to MSDOS machines. 

I have called Ron's coliuim ' 'Small Sys- 
tem Support", since he indicated that 
his many years of designing and work- 
ing on embedded controllers will be his 
primary beat. Like many of our other 
writers, he will actually cover many top- 
ics, from reviewing and helping others 
to keep their old 6809 platforms run- 
ning, to broaching old ideas but using 
new platforms for their solutions. 

If you have airy doubts about his ability 
to meet our needs and challenges, I am 
sure they will be all gone after reading 
both his letter and first article. Welcome 
aboard Ron! 

Our Reader to Reader has more than 
Ron's letter. There is plenty to keep you 
interested and educated. Brad Rodriguez 
has an announcement of a contest that 
should perk up your attention if your do 
embedded controls. All starts on the next 
page... 

I have finally gotten around to adding 
more information to JW Weavers col- 
umn, so that you can find all of TCJ 
author's contact information in one place 
instead of their own articles. So check 
out the Siqjport Groups section and see 



if your local group needs to have their 
added. 

Charles Stafford shows us how to up- 
grade some Kaypro's, while Jay Sage 
provides part 2 of using PMATE MAC- 
ROS. For more regular support, Rick 
Rodman fills us in on how well LINUX 
worked for him. Rick also explains some 
insides of LINKING and a possible idea 
doing with linking all our computers 
together. 

On the special side we continue with part 
3 of Tilmann Reh's series on IDE drives. 
We get more information on their com- 
mands and a sample PASCAL program 
to see if we can read our drives identifi- 
cation information. This is all part of his 
making sure we understand enough about 
IDE drives to be able to write our own 
interface device drivers. 

We follow Tilmann's article with more 
disk drive interfacing, by having Herb 
Johnson continue his series on develop- 
ing your own disk drive software or BIOS, 
This time we review some of the CP/M 
commands and hardware arrangements 
needed to develop the BIOS code. 

The long awaited Small-C article is here. 
I must confess that I feel a part 2 coming 
on. Like any complex topic, choosing a 
universal language is no simple task. 
The article covers some good and bad 
points of C and other alternatives. I con- 
clude the article with short descriptions 
of The C Users Group disks that have a 
version of Small-C on them. Since not 
all versions were covered, I hope that 
some of you can send in more reports 
(like J. G. Owens) on other versions you 
have personal experience with. 

Fortunately I asked Brad to keep it short 
this time (he also had to present some 
studies at the University) so his article 



this issue deals with moving Forth and 
some decisions you need to consider. 
My objective over the next few issues is 
to try and get not only Brad but everyone 
else to give me about 4 printed pages per 
issues. 

It appears I have several articles I would 
like to use but seem to be short a page or 
two. I had to add two extra pages just to 
get our regulars. My position is to print 
whatever it takes, but if possible I think 
about 4 TCJ pages each should be 
enough. That means of course that some 
writers will do a 3 pager one time and 6 
the next. Hopefully not all will do 6 
pages at the same time or I am in big 
trouble. 

Speaking of troubles, I have made some 
important decisions based on other hap- 
penings that all our readers need to find 
out about. They are all covered in my 
Computer Comer. The most earth shak- 
ing is finally deciding to support PC7XT 
machines! That support will be limited 
and clearly defmed as explained in my 
column. So check out our new position 
and more. 

That is about all your going to get this 
issue, and if it isn't enough, it is only 
because your comments and letters 
haven't been received yet. The Com- 
puter Journal has always been your 
magazine, and if you don't see or like 
something, just drop me a note and we 
will consider our options. I can't guar- 
antee every request will be granted, but 
then I can't grant anything I don't know 
about. So write and thanks for support- 
ing TCJ\ 
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READER to READER 



Letters to the Editor 

All Readers 

MINI Articles 



Dear Bill, 

I received the three issues of TC/ yester- 
day. Ive read the tenth anniversary is- 
sue through cover to cover, and read a 
lot of the others as well. I wonder why I 
hadn't run across your publication be- 
fore. Perhaps it was because of the em- 
phasis on CP/M and FORTH that no- 
body called it to my attention. No mat- 
ter. While I was waiting for the back 
issues I began to write an introductory 
column. It turned out to be a history of 
the 6800/6809 systems that parallels the 
one in the tenth anniversary issue cover- 
ing the 8080 /Z80 machines. I had al- 
ready done it as an ASCII file when I 
discovered yesterday that you use 
WordStar 7.0, which I am using today to 
write this letter. I have a package called 
Emulaser with which I can do wonders 
with Post Script fonts etc. The printer is 
a Citizen GSX-I40. 

The material I've submitted (on the en- 
closed disk) is really two subjects. First 
there is some history, but I found myself 
reading all my old stuff in '68 ' Micro 
Journal and remembering all that good 
software, most of which I still have 
around, for the 6809 FLEX system 
(which I also still have around). I 
couldn't help preparing a list of suppli- 
ers and their last known address. Maybe 
this will help some of your readers who 
have stumbled onto 6809 systems and 
wonder what to do with them. If you 
would like to separate these two sub- 
jects, just do so, or let me know and I 
will do it for you. I would hope the 
subject matter won't undermine or dis- 
turb anyone else you have lined up to do 
680X material too. I'm open to any and 
all suggestions. 



I noted a bit of dissatisfaction on the part 
of one reader who sent all his back issue 
back to you. Being an outsider as far as 
the CP/M world is concerned, I can eas- 
ily agree with that reader. One rule 
ought to be not to use a mnemonic with- 
out spelling it out at least the first time 
it is used. You have new subscribers all 
the time, and even in the third part of a 
multi-part article, the author ought not 
to assume that the reader understands a 
nmemonic automatically. 

I have some mixed feelings about your 
mix of articles and your mission (which 
I may not understand correctly). I couldn't 
agree more with the idea that these old 
8 bit systems are easier to understand 
and better computers on which to learn 
what computers are all about. If these 
are really to be found for under $100 at 
swap meets, they would certainly be ideal 
for someone on a small budget to use to 
learn about computers. On the other 
hand I detect something between dis- 
dain and contempt for those "IBM" 
boxes. Come on, folks. BeUeve it or not, 
programming an 8250 (16450 in the 
newer serial applications) is no harder 
than programming a 6850 serial inter- 
face, or, I'm sure, the Intel equivalent. 
Give me a chance with some articles and 
I'll prove that. I recently needed to write 
a pair of programs to allow a consulting 
client to transfer a large amount of data 
files from a SWTPc system using 8" 
floppies, to a new 486 system, on 3.5" 
1.44 Mbyte disks. I of course chose a 
serial interface at each end, in order to 
keep it simple. The 6809 end had a 6850 
which can be initialized in a couple of 
lines of code. The baud rate is set with 
jumpers on the serial board. The IBM 
end didn't yield to my attempts to set the 
port up using the MODE command from 



DOS nor did it work as indicated when 
I tried to use some of the Borland Turbo 
C library functions to set it up. When I 
found an 8250 data sheet, I found it no 
more difficult than the 6850, except of 
course that it has more steps since the 
baud rate is programmable too. I was 
even able to use the RTS handshake 
(Request TO Send) from the IBM to the 
CTS (Clear To Send) of the 6809 so I 
could stop the data flow while writing 
data to the 3.5" floppy. It just isn't that 
much harder and you don't have to go 
through high level library fimctions OR 
BIOS functions to do it. 

When 1 translated my editor PIE to Turbo 
C for IBM use, I found that writing to 
the screen using BIOS calls was unac- 
ceptably slow. (This was back on an old 
XT about 42 times slower than my 
present 386DX-40). It was not much of 
a project to write directly to VIDEO 
RAM. The routines were easier than try- 
ing to do a screen oriented editor on a 
serial terminal and I didn't have to re- 
sort to Assembly code to do the job, and 
do 20 terminal configuration files for 20 
different terminals. 

I also detect contempt for "C". C, I've 
found just as viable as a procedural lan- 
guage as is Pascal. I cut my teeth on 
Pascal years ago, and at first found C to 
be quite cryptic. I have news for you. 
When I translated PIE fi-om Pascal to C. 
I found that I could do it line for line, 
though not getting into the "true spirit" 
of C. You don't have to use the ridicu- 
lous features. I read about the question 
mark operator and promptly forget it. In 
Pascal you have to pre-read a character 
from an input file before you can go into 
a read loop to read "while not end of 
file". In C you can combine the getting 
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of the character with the test for end of 
file, and you don't have to have two 
places where a character is read from 
file. 

I guess, my point is that surely the good 
old simple little computes are nice. My 
PAT editor for the 6809 is around 29K 
of object code, about 50 pages of source 
in PL/9. The C version for the IBM 
ended up being about 49K of object code. 
A screen editor with reasonable featmes 
doesn't have to be 500K of object code. 
Pat DOS version has more features such 
as the use of color for marking blocks. It 
runs very much faster on a reasonably 
fast clone. I can edit a huge file and have 
it all in the edit buffer at once as opposed 
to pulling in a section at a time and 
having to write it to disk before pulling 
in another part. Hardware progress is 
hardware progress. Let's not ridicule it. 

On the other hand regarding software, I 
do see a conspiracy on the part of the 
software suppliers to make their pro- 
grams so large as to wipe out the com- 
petitors who can't put 20 or 30 program- 
mers on a project at one time. Buy one 
of the Borland products and I guarantee 
that before you can get it installed you 
will receive an offer for an upgrade for 
only $89.95 plus $12.95 shipping and 
handling. At this point, though I may 
have moved along a bit farther than some 
of you, I draw the line at Windows. 
Windows is an uimecessaiy compUca- 
tion. I'd much rather type a command 
and hit enter, than have to point and 
click my way through 6 menus to do the 
same thing! 

Regarding cost, you gays out there who 
are now finding the bargain oldies are 
really in luck. I figure my 6809 system 
had about $4000 invested in it in its 
heyday. I have three IBM clones that 
haven't cost that in total, thanks to find- 
ing old hard drives at bargain prices, 
and not throwing away old motherboards 
when they are upgraded, etc. 

Well, I've more than said my piece. If 
you can Uve with a cantankerous old 
opinionated grouch (when it comes to 
computers particularly), I would be 
pleased to write a regular column for 
you. Comments and criticisms will be 



greatly appreciated. I'd like to do what 
you want and need for the most part, 
though I reserve the right to needle a bit 
as I have done in this letter. 1 see as 
usual, I will end up with my signature on 
a fresh page! 

Yours truly, Ron Anderson. 

Welcome to TCJ Ron! 

Your line about being a bit opinionated 
(notice I ignored the OLD and Grouch 
part) fits right in with most of us at The 
Computer Journal. As you will find out, 
I am a one person stajf, so when I talk 
about "US" it is the readers who are 
the other members of my staff. I rely on 
them to correct me if I error (or our 
writers) too far in any direction. Your 
background and comments (your history 
is just wonderful) are going to be greatly 
appreciated. 

Let me say you have correctly under- 
stood a number ofTCJ 's positions Learn- 
ing about hardware and software inter- 
facing on any machine is transferable to 
any other platform. My problems about 
recommending IBM Clones for learning 
is based on experience. I have had BIOS 's 
turn off interrupts while trying to do I/O. 
My OS/2 platform crashes two or three 
time a day. Yes the hardware is much 
better (who can complain about having 
a mainfi-ame on your desk), but more 
problems and a much higher level of 
understanding came with them. I guess 
the main issue for TCJ readers is just 
cost. The older machines are cheaper 
still (but clone parts are getting very 
close) and the test equipment is by far 
cheaper. Now if all you want to work on 
is 4 Mhz clones a simple 35MHZ oscil- 
loscope will do just as well here as on a 
4Mhz Z80. It will prove useless on a 
35Mhz 486 Clone however. 

The Computer Journals main objective 
is to teach our readers how to use and 
repair (or keep running) ANY machine 
they chose to use. Since all other com- 
puter magazines in the world have re- 
fused to support or even acknowledge 
that people still use Z80 and 6809 based 
machines for every day tasks, we have 
decided to support as best we can these 
wonderful old machines. Many of our 



readers have found these old machines 
to be works of art and are fascinated 
with them from a collectible aspect (much 
as an antique car collector enjoys his 
collectible old machine). We are limited 
in the amount of coverage we can give 
any platform however, due mostly from 
lack of advertisers and limited number 
of pages. I felt strongly that several other 
magazines provided (or said they pro- 
vided) technical support of PC clones 
and as such I have no desire to compete 
head on with them. 

It appears now that the support is for the 
new 386/486 machines only, and not the 
older and obsolete PC/XT platforms So 
starting now we are adding the obsolete 
versions of PC Clones to what we sup- 
port. This means that you can digress 
and talkabout those machines as well as 
the better 6809 and other embedded 
systems of which you are sofamilar. We 
can provide support for all the older 
systems (with your help Ron) that can be 
found no where else. Over time I expect 
our readership to grow as the word 
spreads that this is the place to come for 
real hands on support and learning in- 
formation that can be used on any plat- 
form. 

Thanks for not giving up completely on 
the old machines Ron! Welcome again 
to TCJ. Bill Kibler 

Mr. Kibler, 

I am impressed with TCJ. I recently 
started publishing a Tandy Color Com- 
puter, OS-9, and OSK (OS-9/68000) 
magazine myself. So far, all is doing 
very well, ''the world of 68' micros" 
will support other 68xx(x) series miao- 
computers and controllers and other op- 
erating systems for these devices as it 
grows. 

Enclosed you will find ad copy for TCJ 
along with payment for the first two ads. 
I've also enclosed the latest copy of "68' 
micros ' '. 

Would there be any objection to my print- 
ing a story about the 6809 multi-proces- 
sor system? All I would like to do is print 
a description (no schematics) and who 
to contact for the circuit boards. I realize 
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the boards aren't in production, and may 
not be produced... part of the reason I'd 
like to run an article, to help get enough 
boards to do the project. It is a little 
beyond my capabilities and interests at 
the moment, but some of my other read- 
ers may be interested. It is possible that 
OS-9 could be patched to operate on 
such a system. 

I enjoy classic computers a lot myself, 
having my CoCos and a pair of T/S 
models (ZX-81 and T/S 1500). I got the 
CoCo after discovering what would be 
involved in connecting a "real" printer 
to the 1500.. I intended to use it for word 
processing. After researching the home 
market at the time (1984-85), I decided 
the CoCo offered the most bang for the 
buck and cheapest expandability. I didn't 
learn much from Tandy, but from maga- 
zines and users. 

Keep up the good work! 
Francis G. Swygert 
Editor, "68 'micros" 

Thanks Francis for the copy of your 
magazine. I was impressed that you have 
been able to get so much going in Just a 
couple of issues. Your action supports 
my position that it is only a period of 
time before "collectible" computers 
becomes an industry of itself. 

We do not allow full reprinting of our 
articles, however reviews or synopsis 
are allowed. The Z-Letter prints a re- 
view in each of his issues about what 
other support magazines and newsletter 
have done in their last issue. Since most 
of our support is by word of mouth, any 
plugs we can get and give each other 
will be greatly appreciated. 

You will enjoy the next issue, as it is a 
special on the ZX-81. I have received 
lots of material on the ZX-81 and will try 
and review it all (not an easy task!) next 
issue. So, welcome to TCJ as both a 
reader and advertiser, not to mention a 
supporter of classic systems. Bill. 

Dear Bill, 

I had almost decided not to renew TCJ 
- I'm not a big Intel/Zilog/CPM fan. So 
issue number 61 was going to be my last; 



not because the magazine wasn't well 
done or lacked meat, it just wasn't useful 
to me. 

Then I picked up that issue 6 1 , and turned 
to the end of the magazine, and found 
just what the doctor ordered! Yes, yes, 
yes, do it! Your ideas concerning the use 
of Small-C and Forth are right on. I 
suggest you use mainly Small-C because, 
while I personally use Forth, most people 
find it objectionable. And a Small-C 
complier can probably be made to gen- 
erate tighter code than Forth. 

I would also encourage you not to go 
overboard on picking up the pieces of 
has-been publications (e.g. 68xxx Mi- 
cro-Journal, et. all). Here again, I prefer 
68xxx architectures, but I want to move 
forward. Let's do the Small-C tools set, 
and then move to the development of an 
OS that meets todays standards (real- 
time, multi-threaded, multi-tasking). If 
it's done modular, with different (small) 
kernels for different folks, and written in 
our Small-C, it can be easily adapted to 
everyone's needs. 

The critical thing in my mind is to keep 
things from becoming so complex that 
one person of average inteUigence can 
no longer get wrapped around it all. 
Keep the compilers and OS reasonably 
simple, and let the complexity be added 
at the application level by only those 
who need it. 

Finally, besides your very admirable 
objective of education, also be aware of 
major problem areas of your readers. Oh 
why oh why can I not find a supplier that 
will sell me by mail order a couple 
MC683xx chips? Why do I have to still 
be stuck with articles that use almost two 
decade old 6809 chips when 683xx are 
so much more desirable? One 68306, a 
couple of DRAM chips, and one EPROM 
is all you need to make a fantastic sys- 
tem; it even has the DRAM refresh built 
in! As far as I'm concerned, finding 
friendly suppliers is right at the top of 
my problem list; there are many publica- 
tions that help providing me with the 
information I need, but getting the ma- 
terials I need to make use of that info is 
a serious problem. Addressing this prob- 
lem is worth a monthly column in my 



opimon. 

Well, you did ask for our input! Seri- 
ously, I very much like your suggested 
new direction. I'm willing to continue 
my support. 

Sincerely, David F. Klink 

Thanks for the support David. Actually 
my search for an universal operating 
system is a very old project. In consid- 
ering using Small-C you had better read 
the Small-C article in this issue. Those 
with experience using it have made some 
good comments and expressed their con- 
cerns. It is beginning to look like if we 
are to use Small-C some form of multi- 
pass compiling will be needed (as done 
with OS-9 C compiler). I think any ma- 
jor operating system project should be 
handled the same. Break the project and 
the pieces into small parts for different 
people to work on. The results too would 
be in small units that can be loaded only 
if needed. 

My getting rights to back issues of other 
magazines is just making sure they van- 
ish for good. Lots of very important work 
was done back then which I would hate 
to see in the trash dump. Yes we are 
movingforward. but looking back on the 
past and building on what was done is 
important. That goes for the latest 68K 
chips which I think (and hope) we will 
have an article about soon. Peter Stark 
of SK*DOS is considering doing just 
such an article, but is just not sure our 
readers want it. 

You correctly identified the problem with 
using new chips and why Brad is using 
6809s in his project. Let me say how- 
ever, that the 6809 is considerably bet- 
ter than most users give it credit for 
being. But Brad is using it mostly be- 
cause they are cheap and available. One 
of my constraints on articles, is the parts 
must be easily available. I have been 
personally looking for a source of 
68306 's with out any luck. I am sure I 
could get samples, but that does our 
readers little good. Since I can 'tfmd a 
source I can 't even determine cost This 
problem explains one of the reasons we 
push using older systems for projects. 
With old units, the parts are still avail- 
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able and inexpensive as well. Also re- 
member that what you learn can be trans- 
ferred to the new systems. Like the 68306 
which I know Brad would rather use if it 
was easily available. 

We like things simple at TCJ, and your 
letter and support is greatly appreci- 
ated. How about some comments on the 
Small-C project from you? Thanks for 
the letter! Bill. 

Dear Bill, 

Attached is the copy of my reply to John 
Butler in Lx)ndon. I have a fairly exten- 
sive collection of some of the older com- 
puter magazines and maybe able to help 
out anyone looking for articles in them. 

Dear John: 

Noting your letter in the current issue of 
TCJ, asking for help in locating several 
articles on old issues of Microsystems 
and Interface Age, I searched my cha- 
otic attic and came up with the follow- 
ing: 

Relocating Assemblers and Linkage 
Editors: paitl. Microsystems, June 1983. 
Ibid., Part 2, October 1983. Ibid., Part 3, 
January 1984. 

Structured Programming with Microsoft 
M80 Assembler: Micro/systems Journal, 
July/August 1985. 

I'm enclosing photocopies of the articles, 
and hope you find them useful. 

I'm pretty sure I also have the issue of 
Interface Age with the article you're 
looking for, but so far haven't been able 
to put my hands on it. If it tiuiis up, I'll 
copy the article and send it along to you. 

With all good wishes, Norman F. 
Stanley, Rockland, ME. 

Thankymt for helpingout John, Norman! 
It is not often that I actually find out if 
someone got help or not. Keeping track 
of all the back issues and many of those 
very important articles has actually been 
suggested by a few of our readers, as 
something TCJ should be doing, since 
my space and time is limited, I have to 



rely on people like you. So again thanks 
for your help! Bill. 

Dear Bill, 

I am working on a project to put together 
a public domain/shareware CD-ROM 
containing articles on the subjects of 
Macintosh Computer Data Acquisition 
and Data Analysis to be published by the 
Macintosh Scientific and Technical Us- 
ers Association. The CD will be pro- 
moted to the MacSciTech members 
(1500), the readers of the SciTech Jour- 
nal (10,000 per issue) and sold at vari- 
ous MacSciTech conferences. 

I am reviewing previous issues of your 
publication looking for articles I'd like 
to include. 1 will contact you later with 
specific requests. Please let me know if 
you are willing to grant permission for 
reprints. 

Would it be possible for you to give me 
articles in computer-readable format? 1 
would prefer Macintosh text files, but I 
can deal with DOS text files if neces- 
sary. 

You may contact Mike Duncan of 
MacSciTech if you have any questions. 

Gus Calabrese. 

Glad to hear that your putting together 
a Mac CDROM, Gus. Our CP/M 
CDROM should be done about now. I 
have been using CDROMs lately and 
find them just wonderful. I was unable to 
get more than a sample of TCJ into our 
ROM. My time and amount of computer 
ready data is almost non existent. I plan 
to contact both previous editors and get 
what ever disks they have, but for now, 
I only have printed back issues and am 
not about to retype them all. As far as 
rights to reprint the entire article, no, 
because I still sell all back issues and 
they are a major reason for TCJ break- 
ing even (and keeping cost down). You 
can print a synopsis or review with in- 
formation on how to get back issues 
without my permission if that will help. 



Please let us know how the CDROM 
comes out, and thanks for supporting 
TCJ. Bill Kibler. 



To: B.KEBLER 
Sub: news release 



Could you be... 

THE WORLD'S FASTEST PRO- 
GRAMMER? 

On March 8, 1994, the ACM Special 
Interest Group on Forth (SlGForth) will 
invite fifty programmers to joust with 
computer and compiler, to vie for the 
title of "World's Fastest Programmer." 
Individuals and teams will compete to 
program a physical ' 'gizmo' ' in the short- 
est possible time, using the computer 
and language of their choice. 

First held in 1988 under the auspices of 
the Forth Interest Group, the World's 
Fastest Programmer contest has traveled 
from California to Europe, and now ar- 
rives in Phoenix, Arizona for the 1994 
Symposium on Applied Computing. This 
symposiiun is jointly held by six Special 
Interest Groups of the Association for 
Computing Machinery: 

SIGAPP (Applied Computing) 

SIGAPL (APL) 

SIGBIO (Biomedical Computing) 

SIGCUE (Computer Uses in Education) 

SIGSMALL/PC (Personal and Small Computers) 

SIGFORTH (Forth) 

Now's your chance to prove the worth of 
your platform, language, or program- 
ming methodology! Any computer that 
supports a parallel printer can be used. 
Entrants (individuals or teams) need not 
be members of ACM or SlGForth, but 
only fifty can compete, so register now! 

REGISTRATION 

The contest registration fee is $25 (U. S.), 
payable to ACM SlGForth (U.S. checks 
or money orders only, please). Send 
your name, address, and a check or 
money order to the contest chairman: 

Brad Rodriguez 

Box 77, McMaster University 

1280 Main Street West 



6 



The Computer Journal / #64 



Hamilton, Ontario L8S ICO Canada 

email: B.R0DRIGUEZ2 on GEnie, or 
b.rodriguez2@genie.geis.com on 
Internet. 

(U.S. entrants note: first class postage to 
Canada is 40 cents!) 

For team entrants, only one member need 
register. You may register by email; 
however, your registration will not be 
accepted until the $25 fee is received. 
Participation is limited to the first fifty 
registrations received by December 31, 
1993. Cancellations after December 31, 
1993 will forfeit the registration fee. (The 
contest organizers reserve the right to 
extend the registration period at their 
discretion.) 

The contest will be held at the Phoenix 
Civic Plaza, in conjunction with the 1 994 
Symposiimi on Apphed Computing (SAC 
'94) and the 1994 ACM Computer Sci- 
ence Conference (CSC '94). While in 
Phoenix you may wish to attend SAC 
'94. For registration information, con- 
tact: 

Ed Deaton, Conference Director 
Department of Computer Science 
Hope College 
Holland, Michigan 49422 USA 

email: deaton@cs.hope.edu 

SAC '94 can also provide information 
on housing in Phoenix. 

CONTEST RULES 

The object of the contest is to solve a 
real-time progranuning problem in the 
shortest time. This problem will involve 
a hardware ' 'gizmo' ' to be controlled by 
a computer. Rules: 

1. Entrants may be individuals or teams. 
Teams may have any number of mem- 
bers. 

2. The "gizmo" will be supplied by the 
contest organizers at the commencement 
of the contest. Only one gizmo will be 
supplied to each entrant (i.e., only one 
gizmo per team). 



3. Entrants may use any programming 
language(s). 

4. Entrants may use any computer(s), 
and any number of computers. Entrants 
must supply their own computer(s). 

5. Entrants must ensure that their com- 
puter has an interface suitable for the 
gizmo, as follows: 

a. The computer must provide 8 bits of 
parallel output, and 1 bit of parallel in- 
put which can be read by software (i.e., 
not an interrupt input). 

b. The gizmo will use a standard 
Centronics-type 36-pin female connec- 
tor, and will electrically resemble a stan- 
dard "IBM PC compatible" parallel 
printer. Pins 2 through 9 on this con- 
nector (D0-D7) will be the 8 data inputs 
of the gizmo. The data output of the 
gizmo will api)ear simultaneously on pins 
II (BUSY), 12 (PAPER END), and 13 
(ON LINE). Ground will be pins 19 
through 30. TTL levels will be used. All 
other pins will be unconnected. 

c. Entrants must supply their own cables. 
A cable that connects the computer to a 
standard parallel printer should be satis- 
factory; however, it is the responsibility 
of each entrant to verify that the signal 
assigiunents given above are compatible 
with their computer's parallel port, and 
to provide any necessary adapters. 

d. The gizmo will not require power 
fi'om the computer. 

e. The contest organizers will exercise 
care in the design and construction of 
the gizmo. However, the organizers 
assume no responsibility for any damage 
to any entrant's computer(s), caused by 
connection to the gizmo. 

6. No other information about the gizmo 
will be provided until the start of the 
contest. 

7. No information about the problem to 
be solved will be provided until the start 
of the contest. 

9. The winner of the contest will be the 
entrant who completes the assigned prob- 



lem in the shortest time after the start of 
the contest. Completion criteria will be 
provided in the problem description; but 
no entry will be deemed complete until 
so pronounced by the Judges. 

10. Entrants must provide their source 
code to the contest organizers at the 
conclusion of the contest. Entrants will 
retain fiill rights to their work. How- 
ever, by entering this contest, each en- 
trant agrees to grant the contest sponsors 
and contest organizers unlimited right 
to use, publish, or distribute their contest 
entries. (In particular, the contest orga- 
nizers intend to publish the winning entry 
in a suitable journal.) 

1 1. All disputes about the interpretation 
of these rules, and all other matters per- 
taining to this contest, will be decided by 
contest judge(s) to be named by the con- 
test organizers. The decision of the 
judge(s) will be final. 

12. Participation will be limited to the 
first fifty (50) entrants whose applica- 
tions are received by 31 December 1993. 

=END= 

Thanks for the notice Brad I was unable 
to attend the gizmo contests, but one of 
our local Forth members did. He said it 
was just great to watch how all the dif- 
ferent teams worked. He really learned 
a lot and enjoyed himself as well. The 
next couple of Forth meeting we had our 
own mini-contests as we all brought one 
item or another. I had a stepper motor 
driven by 68HC11 using Forth. The 
object was how little code was needed to 
make it move to any given location. Was 
simply fun and livened up the meeting. 

Now Brad, I expect to get an article 
from you on this, correct? Bill. 

Dear Bill, 

Please change my address to 

Note that Sound Potentials, which used 
to distribute a collection of public do- 
main CP/M software, is no longer in 
business. The software collection was 
acquired by Lambda Software Publish- 
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ing, i.e. Mr. David A.J. McGIone, who 
publishes the Z-Letter, and remains avail- 
able from him. 

I have subscribed to TCJ since issue #48, 
primarily for articles relating to CP/M 
and Z-Systems. My CP/M systems in- 
clude a hopped-up Kaypro 4-84, which 
has a 1 MB Advent RAM disk, two quad 
density drives {782K) and one double 
density drive. I also own two Epson PX- 
8 Geneva CP/M portable computers with 
the wedge attachments for extra RAM. I 
now frequently use an 80386DX-40 Mhz 
IBM Clone, on which I run a registered 
version of MYZ80. This makes a high 
performance CP/M system, especially 
when running ZCPR34. I would be in- 
terested in any information or articles 
concerning MYZ80. 

My wife, Diana, has been promoted in 
her company, hence our move to Rich- 
mond. I will seek computer program- 
ming work there. I recently completed a 
B.S. degree in Computer Information 
Systems from Regents College, 1450 
Western Ave., Albany NY 12203-3524. 
This is a fiilly-accredited program of the 
University of the State of New York that 
can be completed without ever going to 
Albany or even to New York State. If 
any TCJ reader has been contemplating 
a B.S. in computing, I recommend this 
"distance learning" program. If you 
have any existing college credits, they 
can be applied to the program. I already 
had a B.A. degree with a freshman year 
that was filled with engineering courses. 
I was able to complete the B.S. degree in 
one year by taking seven courses plus 
G.RE. in Computer Science. The Com- 
puter Information systems degree differs 
slightly from a standard Computer Sci- 
ence degree in that the mathematics re- 
quirement is a bit lower, and there are 
additional requirements for Systems 
Analysis and Design, and Database 
Management Systems. 

Very truly yours, Richard E. Brewster. 

Thanks for the information Richard. I 
had seen in The Z-Letter that you had 
transferred Sound Potential 's software 
to David. David is doing well in his new 
Eugene location. 



It looks like you have a good assortment 
of CP/M systems. Yes, MYZ80 is great, 
especially running ZCPR. We have only 
had one past article on it, but would love 
to see more! 

The degree idea sounds great and hope- 
fully some of our readers will give them 
a ring to find out more. Thanks. Bill. 

Dear Bill: 

Re: Superbrain Hard Disk Boards, Sche- 
matics, ETC. 

I was pleased to have a chat with you a 
couple of days ago when I phoned to 
commence my first subscription to TCJ. 

I use Intertec Superbrains and, unlike 
most people, do not use an MSDOS, or 
any other, computer. The Superbrains 
are very heavily used for DBASE II 
programmes for agricultural research, 
for word processing with Magic Wand/ 
Peachtrext, and to a lesser extent for 
computer conununications. Some day 
when time permits, I will be converting 
a number of BASIC statistical 
programmes I wrote for the Hewlett- 
Packard 9830 to run under MBASIC on 
the Superbrains. I have just bought Z- 
SYSTEM and am struggling to install it. 

I use CMC controller and interface boards 
to run two 10 MB Hard disks on the 
Superbrain, each configured as two logi- 
cal disks with 1024 directory entries. 

Since losing one of my hard disk con- 
troller boards when my hard drive power 
supply blew up, my major problem has 
been one of trying to find a good spare 
CMC controller board or two. So far I 
have had no luck. 

The CMC boards I am looking for were 
originally used with CMC OEM 
Superbrains called "Super Five", "Su- 
per Ten", or "Super 20" and were also 
used to upgrade many factory standard 
Superbrains and Compustars. 

The CMC controller board set consisted 
of 2 boards, usually green. Both bore the 
trade name "act". The smaller board 



also said "HOP-8". The larger board 
said "5MSDC" and, immediately be- 
neath, "REV-3". 

I am also interested in Superbrain (or 
Compustar) boards and accessories of 
all kind, schematics for the CMC hard 
drive boards, schematics for a Superbrain 
II, information for adding IDE hard 
disks, adding a parallel port, etc. for the 
Superbrain. 

If anyone knows of available CMC or 
Superbrain boards (or the whole hard 
drive unit or computer), or has informa- 
tion regarding any of the above, I would 
appreciate being informed. I can be 
reached as follows: .. 

Brian Murphy, Fidonet 1:153/151, or 
12521 Cathy Cr, RR#7, Mission, B>C> 
V2V6H5, Canada. Call (604) 462-7057. 

I am eagerly looking forward to a year of 
receiving TCJ. 

Sincerely yours. Brain C. Murphy. 

OK Brain, I can help for many of what 
you need. I have several Superbrain sche- 
matics and a whole Superbrain QD with 
parallel port. I did the parallel port some 
time ago and wrote an article in issue 
#32 as part of my Computer Comer. 
One problem with my 10 years of 
Comer 's is that they are not indexed by 
topic. I did several projects and have to 
thumb through them to find which issue 
the discussion is in. I guess that is a 
good reason to just have all of the back 
issues. I never seem to be amazed at 
what I find while looking for something 
else. 

I had intended on keeping the Superbrain, 
but lately I am a bit over loaded and 
might consider selling it. How much and 
then how to get it to Canada is another 
problem. Lets hope you can find help a 
bit more locally. As for hard drives sup- 
port I have none, either drives or sup- 
port. Let us know if you find help how- 
ever. 

Thanks for still using classic machine! 
Bill Kibler. 
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Dear Bill; 

Enclosed is my check in the amount of 
$44.00 to renew my subscription for 
another two years, though my ' 'EXP" is 
65, I am renewing early to avoid any 
chance of missing an issue. 

I am operating under Turix)Dos in an 
SI 00 configuration. My system is pres- 
ently set up for eight users and three 
printers. TiulwDos could handle sixteen 
of each. Would you be interested in an 
article about this alternate CPM 
multiuser, multifimctioning system? I 
m^ even have schematics on my Teletek 
and Earth boards. 

Sincerely, Rosenthal & Associates PC, 
Harold Rosenthal. 

Yes and thanks Harold 1 wish more 
people would renew on their own early. 
Early renewal saves me money and time 
which I have so little of these days. As 
for an article on TurboDos a big YES. I 
once worked for Teletek and had chance 
to use TurboDos before I left. Their 
multiuser systems were the best, unfor- 
tunately I can 't say same for the man- 
agement What made them so great was 
the single CPU for each user, something 
the MSDOS folks haven 't learned about 
yet. So hopefully you can do an article 
and explain what I just said to our read- 
ers! Thanks again. Bill Kibler. 

Dear Mr. Kibler, 

Enclosed please find my renewal for 
another year. 

I run CP/M 2.2 on an Apple//e 
(unenhanced) (Microsoft Softcard) and 
also CP/M 3.0 using Digital Research 
Goldcard. I also use MSDOS Clones at 
home and at work. 

It never ceases to amaze me that each 
new version of a program requires a 
doubling of the amount of disk space 
and a 50% increase in the amount of 
RAM required for an almost fiinction- 
ally equivalent program. A program that 
used to require 48K of RAM and fit on 
a single-sided, double-density disk (not 
compressed) now comes on 8 highly 
compressed high density disks and re- 



quires 20 megabytes on a hard drive 
when installed. I realize that memory is 
relatively cheap now and that CPUs and 
hard disks are faster, but this increase in 
space and requirements offends my aes- 
thetics. 

Do you know of a source of CP/M soft- 
ware on 5 1/4 inch Apple Softcard for- 
matted disks? All the references to CP/ 
M software seems to be for Kaypro and 
Radio Shack computers and this cuts out 
many of the "old-timers" who have the 
Apple - Softcard configuration. Does the 
software you distribute come in this for- 
mat? 

Thank you for your assistance. 

Sincerely, Jim Moore. 

Thanks for the renewal Jim. Lambda 
Software I believe can copy software 
onto that format for you. In fact David 
Just told me he is becoming the Borland 
CP/M software distributor. So he may 
soon have all versions of Borland CP/M 
software for your system. He also has 
the Z-Letter which might be a help for 
you. Give him a call, his number is on 
the back page. 

You also correctly mentioned one of the 
reasons I am thinking about giving up 
MSDOS systems and going back to CP/ 
Mfull time. Of course one doesn 't have 
to get the latest, but I usually find that 
I hope the newest version will have all 
the bugs I found fixed. Unfortunately 
that usually is not the case. In adding all 
those new features, they miss some of 
the old bugs and put in many more new 
ones Seems you can 't win, so why join 
them. Use CP/M sojhvare that works 
and has all the bugs worked out of it! 

Thanks for your interest in TCJ and CP/ 
M! Bill Kibler. 



Articles Nededed 

We need articles on subjects that 
are of interests to our readers. Those 
interests now span small and older 
eight bit systems, through the obso- 
lete IBM PC/XT style of comput- 
ers. 

The subjea matter of interest are 
mostly those which explain and 
teach readers how to perform inter- 
mediate and advanced improve- 
ments and modifications to their 
systems. 

All of TCJ's readers are not inter- 
mediate in skill, many are begin- 
ners. Articles need to take any reader 
of any skill level through your 
project, as if they were begining on 
this subject for the first time. 

Areas of current interest are using 
older and obsolete systems for new 
embedded control situations. 

Embedding operations in ROM and 
running the entire operations for 
remote sensing over a telephone line 
would be a great article of interest 
to our readers. 

First hand reports on the history of 
early and classic systems is always 
a topic which our readers enjoy. 

Projects which use surplus parts 
available from current vendors, 
showing how to debug and develop 
the needed knowledge of the used 
system, is something of interest to 
our readers and advertizers as well. 

Short reports oh projects that are 
currently under way, belong in our 
Support Groups section, where let- 
ting others know of what is being 
done has become a major focus. 

Send your letters to: 

The Computer Journal 

P.O. Box 535 
Lincoln, CA 95648-0535 
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Regular Feature SUPPORT GROUPS FOR THE CLASSICS 



Classic Support 
Group Reviews 



By JW Weaver 



Well here it is, another issue due, and par for the coiu'se, I'm 
in a mad rush to get this article ready for Bill. 

On my request for help with information and/or history of 
conqjuter companies, I've received a response from a fellow in 
Iowa, with information concerning the Morrow system. Did 
not know that Monow produced so many variations. I thank 
the gentleman for his letter, and hope to include a bit of this 
information in the next column. 

Had some suggestions from Tilmann Reh and Bill Kibler 
towards changing the direction of this column. Will try to 
include their suggestions, and if you the reader have any 
suggestions for improvements or other directions or subjects, 
you would like to see covered, please drop me a note. 

I Would like to include within this column, projects that 
readers are doing for the classics, information on these projects, 
if these projects will be available to other readers, or if your 
project might need some help. Firmly belive that there are 
readers with projects, un-aware that other readers would like 
to become involved, might Uke to duplicate it, or might like 
to aquire kit / finished product. 

With the onset of winter, my outdoor time will be dwindling, 
that means I will have more time to put in on a few of my own 
projects. One of these projects, is designing a replacement 
board for my Kaypro, basicaly a Z181 processor with a SCSI 
interface, higher speed serial ports, hopefiiUy support for 8" 
floppy ( external of course ), 1 .2 meg , 1 .44 meg as well as the 
orignal formats. Another project is designing a simple but 
fuctional computer, buiU from mostly descrete logic, to aid in 
teaching my two young daughters, fundamentals of soldering 
and testing circuit boards, and the concepts of computers, how 
they work, and how to program. 

Well enoght of my rambling, Need to wrap this up and post 
to BBS for Bill K. 

An after note, any persons trying to contact me, via my BBS, 
in the last 3 weeks of October, I must apologize, when I 
replaced the crashed hard drive, I also changed the BBS soft- 
ware, and due to my NOT thoroughly wringing out the pack- 
age, I overlooked a few options which placed the BBS into 
some strange modes. Sometimes not anwersing incoming 



calls, sometimes anwersing but not allowing access. Please try 
again, Hopefiilly I have corrected the problems. 

Keep Hacking. 

Contact by US Mail: 
TCJ Support Groups 
Drawer 180 
Volcano, California 

Contact by BBS: 

(916) 427-9038 

up to 2400 baud 8 bits N parity 1 stop 

TCJ Staff Contacts 

TCJ Editor: 

Bill D. Kibler, PO Box 535, Lincoln, CA 95648, (916)645-1670, 

GEnie: B. Kibler, CompuServe: 71563,2243, E-mail: 

B.Kibler@Genie.geis.com. 

Z-System Support: 

Jay Sage, 1435 Centre St. Newton Centre, MA 021 59-2469, (617)965- 
3552, BBS: (617)965-7259(pw=DDT), MABOS on PC-Pursuit, E- 
mail: Sage@ll.mit.edu. Also sells Z-System software, see inside 
front cover. 

32Bit Support; 

Rick Rodman, BBS:(703)330-9049 (eves). E-mail: 

rickr@virtech.vti.com. 

Kaypro Support: 

Charles Stafford, 4000 Noiris Ave. , Sacramento, CA 9582 1 , (9 1 6>483- 

0312 (eves). Also sells Kaypro upgrades, see ad inside back cover. 

S-100 Support: 

Herb Johnson, CN 5256 #105, Princeton, NJ 08543, (609)771-1503. 

Also sells used S-100 boards and systems, see inside back cover. 

6809 Support: 

Ronald Anderson, 3540 Sturbridge Ct., Ann Arbor, MI 48105. 

Users Groups and Project Reports: 

JW Weaver, Drawer 180, Volcano, CA 95689, BBS: (916)427-9038. 

Regular Contributors: 

Brad Rodriguez,Box 77, McMaster Univ., 1280 Main St. West, 
Hamilton, ONT, L8S ICO, Canada, Genie: B.Rodriguez2, E-mail: 
b. rodriguez2@genie. geis. com. 
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Frank Sergeant, 809 W. San Antonio St., San Marcos, TX 78666, E- 
mail: fs07675@academia.swt.edu. 

TilmannReh, Germany, E-mail: tilmann.reh@hrz.uni-siegen.d400.de. 
Has complete MS-DOS disk emulation program for C?M+, contact 
Jay Sage. 

USER GROUPS 

Older systems: 

Connecticut CP/M Users Group, contact Stephen Griswold, PO Box 
74, Canton CT 06019-0074, BBS: (203)665-1100. Sponsors East 
Coast Z-fests. 

Sacramento Microcomputer Users Group, PO Box 161513, Sacra- 
mento, CA 95816-1513, BBS: (916)372-3646. Publishes newsletter, 
$15.00 membership, normal meeting is first Thursday at SMUD 
6201 S St.. Sacramento CA. 

Coleco ADAM: 

ADAM-Link User's Group, Salt Lake City, Utah, BBS: (801)484- 

5114. Supporting Coleco ADAM machines, with Newsletter and 

BBS, 

Adam International Media, Adam's House, Route 2, Box 2756, 
1829-1 County Rd. 130, Pearland TX 77581-9503, (713)482-5040. 
Contact Terry R. Fowler for information. 

AUGER, Emerald Coast ADAM Users Group, PO Box 4934, Fort 
Walton Beach FL 32549-4934, (904)244-1516. Contact Norman J. 
Deere, treasurer and editor for pricing and newsletter information. 

MOAUG, Metro Orlando Adam Users Group, Contact James Poulin, 
1146 Manatee Dr. Rockledge FL 32955, (407)631-0958. 

Metro Toronto Adam Group, Box 165, 260 Adelaide St. E., Toronto, 
ONT MSA INO, Canada, (416)424-1352. 

Omaha ADAM Users Club, Contact Norman R. Castro, 809 W. 33rd 
Ave. Bellevue NE 68005, (402)29M405. Suppose to be oldest 
ADAM group. 

OS-9 Support: 

San Diego OS-9 Users Group, Contact Warren Hrach (619)221- 

8246, BBS: (619)224-4878. 

Atari Support: 

ACCESS, PO Box 1354, Sacramento, CA 95812, Contact Bob 

Drews (916)423-1573. Meets fu-st Thurdays at SMUD 59Th St. (ed. 

bldg.). 

Forth Support: 

Forth Interest Group, PO Box 2154, Oakland CA 94621 510-89- 
FORTH. International support of the Forth language. Contact for list 
of local chapters. 

OTHER PUBLICATIONS 

The Z-Letter, supporting Z-System and CP/M users. David A.J. 
McGlone, Lambda Software Publishing, 149 West Hillard Lane, 
Eugene, OR 97404-3057, (503)688-3563. Bi-Monthly user oriented 
newsletter (20 pages+). Also sells CP/M Boot disks, software, and 
new versions of Borland CP/M software. 



The Analytical Engine, by the Computer History Association of 
California, 1001 Elm Ct. El Cerrito, CA 94530-2602. A ASCH text 
file distributed by hitemet, issue #1 was July 1993. E-mail; 
kcrosby@crayola.win.net. 

Z-100 Lifeline, Paul F. Herman hic. , 93 1 7 Amazon Drive, New Port 
Richey FL 34655, (800)346-2152. Publication and products for Z- 
100 and S-100 machines. 

The Staunch 8/89 'er, Kirk L. Thompson editor, PO Box 548, West 
Branch ]A 52358, (319)643-7136. $15/yr(US) publication for H-8/ 
89s. 

Sanyo PC Hackers Newsletter, Victor R. Frank editor, 12450 Sky- 
line Blvd. Woodside, CA 94062^541, (415)851-7031. Support for 
orphaned Sanyo computers and software. 

the world of 68' micros, by FARNA Systems, PO Box 321, Warner 
Robins, GA 31099-0321. E-mail: dsrtfox@delphi.com. New maga- 
zine for support of old CoCo's and other 68xx(x) systems. 

Amstrad PCW SIG, newsletter by Al Warsh, 2751 Reche Cyn Rd. 
#93, Colton, CA 92324. $9 for 6 bi-monthly newsletters on Amstrad 
CP/M machines. 

Other Support Businesses 

Sydex, PO Box 5700, Eugene OR 97405, (503)683-6033. Sells 
several CP/M programs for use with PC Clones (72Disk' format/ 
copies CP/M disks using PC files system). 

Elliam Associates, PO Box 2664, Atascadero CA 93423, (805)466- 
8440. Sells CP/M user group disks and Amstrad PCW products. See 
ad inside back cover. 

Davidge Corp. 94 Commerce Dr. PO Box 1869, Buellton CA 93427, 
(805)688-9598. Z80 support of Davidge and Ampro Z80 Little 
Board. 

Star Technology, 900 Road 170, Carbondale CO, 81623. Epson QX- 
10 support and repairs. New units also avialble. 

Star-K Software Systems Corp. PO Box 209, Mt. Kisco, NY 10549, 
(914)241-0287, BBS: (914)241-3307. 6809/68000 operatmg system 
and software. Some educational products, call for catalog. 

Peripheral Technology, 1480 Terrell Mill Rd. #870, Marietta, GA 
30067, (404)973-2156. 6809/68000 single board system. 68K ISA 
bus compatible system. See inside front cover. 

Hazelwood Computers, RR# 1 , Box 36, Hwy 94@Blufflon, Rhineland, 
MO 65069, (314)236-4372. Some SS-50 6809 boards and new 
68000 systems, 

AAA Chicago Computers, Jeny Koppel, (708)202-0 1 50. SS-50 6809 
boards and systems. Very limited quanity, call for information. 
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Mr. Kaypro 

By Charles B. Stafford 



THE NATURE OF THE BEAST 

Wherein we digress from the transmogrification of a mouse 
into a Lion, to acknowledge the existance of (gasp) the "uni- 
versal" mother-board and use the dreaded DDT. 

MEA CULPAs 

When we did the 2 MHz (did I get it right, Lee ?) to 5 MHz 
speed-up, somehow a digit was dropped when specifying the 
clodc divider chip. It was labeled as a 74LS29 but should have 
been 74LS293. To those of you who have been sweating blood 
trying to find one (See it says right here 74LS29), I apologize. 
You should have better luck finding a 74LS293. 

MUSINGS 

There is something insidious about summertime, It may be the 
gentle breezes wafting in from the delta, or it may be the 
temperature, but invariably toward the end, visions of sailing 
and surfing push all other thoughts into the far distant back- 
ground, from whence they return only after the first rains, or 
the first chilly (below 60 degrees) evening. Sometimes sanity 
follows, but only on occasion. During one of these dream 
sequences an 84 Kaypro owner asked, "Can we speed up the 
84s like the 83s ?" A great voice sounded through the mists 
"perhaps." 

Several hours later, while investigation of the proposition pro- 
ceeded, the answer changed to "probably". The entire se- 
quence reminded me that the world of CP/M Kaypros consists 
not only of 83 K-IIs and K-4s but also of K-lOs and those 
machines using the "universal motherboard", i.e. all the 84s. 
So &r, this series has neglected diose late model machines, but 
NO MORE. Herein we will look at fixing the clock on those 
that have it installed, and installing it on those that don't. 

THE LONG AWAITED TRom decoder board 

Sony, this is only an update. The layout of the printed circuit 
board is finished and the prototypes ars being etched, I am told. 
If they are not available in time for the next issue, we will build 
one from scratch, using a piece of perf board with solder pads 
on both sides and through-plated holes, ft works well, but point 
to point wiring is never as neat as printed circuits. 



"THIS COMPUTER WAS STOLEN FROM ..." 

Customizing your sign-on message or 

"here comes the dreaded DDT." 

When I started using a UNIX variant, I was introduced to the 
Vi editor, which is even more convoluted and user-unfriendly 
than Ed or the infamous Edlin. I did learn to use it, however, 
because there was nothing else that would do the same job, i.e. 
imbed executable control and escape characters in executable 
scripts. 

The same is true of DDT, nothing else will quite do the job that 
DDT will. Having said that, I will admit the existance of 
NDDT, a variation that does more, but the underlying operat- 
ing scheme is the same. Here we wiU just use the D(isplay) and 
the S(et) functions to alter the CP/M sign-on message. 

Here's what you'll need; one bootable diskette, with 
M0VCPM.COM 
DDT.COM and 
SYSGEN.COM, all on the diskette, 
another formatted diskette, 
and an ASCII table. 

For those of you who use the TurboRom, you'll need the 
analogous programs, and those required by them. MO VTURBO, 
for instance requires the original M0VCPM.COM and the 
BIOS file, refer to your TurboRom manual for the exact re- 
quirements. 

Here's how we do it: 

1. Turn on your computer, and watch it boot up, preferably 
from the diskette, and write down the exact sign-on message 
that appears on the screen. It will be something like "Kaypro 
CP/M 2.2d" or "61.00K CP/M - TURBO-BIOS". 

2. Use MOVCPM to create an image of the operating system 
on diskette. To do this, issue the command MOVCPM xx.xx 
where xx.xx represents a number between 55.00 and 64.00 
which will be the resulting size of the TPA. ( Transient Pro- 
gram Area, where all those neat programs reside and run ) 
Movcpm will exit with an admonition to save the resulting 
system by issuing the command: "SAVE 36 CP/Mxxxx.sys", 
so do it. For those of you running the TurboRom, Movturbo 
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is the analogous command and it saves the new system all by 
itself. 

3, Now call DDT and the new system into memory with the 
command: DDT CP/Mxxxx.sys (or DDT Turbxxxx.sys as 
appropriate). DDT will sign-on with a message and then give 
you a "-" prompt on the next line. Give the command ' 'd' ' and 
DDT will display the first 16 lines of memory beginning at 
location lOOh, the bottom of the TPA. 

The display will look something like figure 1, with the ad- 
dresses matrixed on the left side and the top line, and 
hexidecimal values in the field. There will also be a column of 
ascii equivalents on the right side. 



()H(X) 


18FE80C2 


80 C2 33 00 


1 A 07 35 36 


2E 30 30 4B 


3.56.00K 


0910 


20 43 SO 2F 


4D 20 2D 20 


54 55 52 42 


4F 2D 42 49 


OP/M - TURBO-BI 


0920 


4F 53 24 20 


20 20 20 20 


20 20 20 20 


20 34 18 B3 


05$ 4.. 


OflVI 


17 2B 19 02 


17F317D2 


00 B1 FF 60 


00 0000 00 


, + '... 


0940 


06 321906 


32 19 06 32 


19 06 3219 


07 0207 00 


.2.2..2..2.... 


nssn 


00 05 0614 


06 44 0613 


06 El 06 05 


06 EB 06 01 


....D 


0960 


06 0008 05 


0E14 0E44 


0E13 0EE1 


OE05 0EEB 


D 


0970 


OE010EOO 


OD OA 57 61 


72 6D 20 42 


6F 8F 74 24 


WarmBootJ 


nsHO 


31 80 C2 21 


F8 FF E5 AF 


06 08 86 23 


10F818 2A 


1..I #...* 


0990 


2711 A0C2 


06 031 A BE 


201E2313 


10 F8 18 2A 


#....' 


09A0 


50 50 531A 


07 52 65 71 


75 69 72 65 


73 20 54 55 


PPS.. Requires TU 


09B0 


52 42 4F 20 


52 4F 4D 21 


21 A3 C2 06 


15 4E23E5 


RB0R0M!I....N# 


U9CU 


C5 CD 45 00 


CI El 10 F5 


F3 78 OE 00 


1E01CD0F 


..E V 


09DO 


001108 00 


19 5E 23 56 


D5 DO E1 2A 


FO FF 70 ED 


..,.»#V...*..V 


OQEO 


47 ED 5E DO 


75 4F11 DO 


DB 73 23 72 


3A F8 FF 07 


G.''.uO...S#R|... 


09F0 


F5 DO E5 El 


11 4C 00 19 


EB F1 F5 3E 


OB 30 02 3E 


....L....>.0.> 



Figure 1 

Successive "d"s will display successive 16 line groups of 
hexidecimal numbers (the contents of memory) with the ascii 
equivalents on the right side of the screen. Continue to scan 
through the memory using the "d' command until you see the 
same message, on the right side in the ascii equivalents col- 
umn, that you carefully wrote down when the machine booted 
up. 

4. Count over from the left side of the right column to the first 
character of the sign-on message, and then count over the same 
number on the address line at the top of the display. Combming 
the number that you landed on at the top of the display with the 
line number that the sign-on message started on will give you 
the starting address of the sign-on message. For instance 07 AO 
+ 05 = 07 A5. Write down the address you came up with. Count 
the number of characters in the sign-on message, and you can 
include trailing spaces, 20h, and write this number down. This 
is the time to figure out what you want your new sign-on 
message to be. You can use the same number of characters as 
the last number you wrote down. When you have your new 
message figured out proceed to step 5. 

5. Using the S(et) command move to the starting address of 
the old sign-on message. You can do this by issuing the 
command "sxxxx" where the xxxx represents the address we 
calculated two paragraphs ago. For instance, using the address 
above the command would be s07A5. This will give you a 
numeric prompt, indicating the memory location and its con- 
tents. Using your ASCII table, translate the first character of 



the new sign-on message to a hex(idecimal) number and enter 
it with a return. The display will reflect the change and the 
prompt will change to the next memory location. Continue 
entering your new message in hex and when you finish enter 
a period(.). If you made a "misteak" enter the "s" command 
again with the appropriate address and fix it, entering a period 
when your finished. 

6. To exit DDT, use a ^C (control C) and then issue the 
command "SAVE 36 NEWCPM.SYS". This writes the first 
36 pages of memory beginning at lOOh to disk, in a file called 
"NEWCPM.SYS". Now all we have to do is install your new 
CP/M on the boot tracks of a diskette. 

7. Issue the command SYSGEN NEWCPM.SYS and the 
response, after much whirring and clicking will be; ' ' Enter 
destination drive or return to rdKWt". Type in the letter of the 
drive where you have a formatted diskette and press "return", 
and follow the prompts. I usually write the system to the disk 
twice, just to make sure. 

Those who use a TurboRom would use TURBOGEN instead of 
SYSGEN, and the commands are otherwise the same. Now put 
the newly "sysgened" diskette in the "A" drive and reboot to 
see your new handiwork. 

A SMALL CAVEAT 

Some times the original system file that you generated with 
MOVCPM will have what looks like a sign-on message in 
several places, because several different people wrote parts of 
the "loader" routine. Kyou don't use the right place the first 
time, just go back to the beginning (step I) and look fiirther. 
You won't do any permanent damage, because we just modi- 
fied a copy of the original file, and floppy boot tracks can be 
rewritten many times. 



THE CASE OF THE MISSING HOURGLASS, or in 
this case real-time clock 

All of the so-called "Universal mother boards" are configured 
for a real-time clock, and a modem. Some even had them 
installed. For those that still lack them, there is good news and 
mediocre news. The mediocre news is that the on-board mo- 
dem was a 300 baud device, and you're better off without it, 
because now you can use an outboard ("external" for you 
HCWs (Highly Certified Wizards)) modem in your choice of 
speeds, at least insofar as your pocketbook will allow. The good 
news is that it's relatively easy to find AND INSTALL the 
pieces necessary to make the on-board clock operational. 

For those who aheady have the clock installed, read on, during 
this adventure we will also tiack down and destroy the entomo- 
logical cybemoid that runs around resetting these clocks to 
random times. 
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"THE INSTALLATION' 



BITS & PIECES 


40 pin 


socket 


24 pin 


socket 


24 pin 


component carrier 


Z80A-PIO 


parallel Input output chip 


MM58167A 


clock chip 


32.768 KHz 


crystal 


1N4148 


diodes (2) 


lOOKohm 


resistor 1/8th watt (1/4 watt will do fine) 


1 uF 


dipped tantalum capacitor 


0.1 uF 


disk capacitor 


22 pF 


disk capacitors (2) 


3 volt 


battery and holder 



INTO THE OPERATING ROOM 

A quick note for us neophytes before we get elbow deep in the 
machine. (You HCWs can skip this part.) The holes at loca- 
tions Y4, U35, U36, CR6, CR7, C54, C64, and C65 are almost 
certainly filled with solder, for two reasons, 1. MURPHY, and 
2. the mother-board is "wave-soldered" during assembly and 
everything that can be gets soldered. SO we need to clean out 
the holes at those locations. You can use either a "solder 
sucker" as described in a previous project or the "soldering 
iron and toothpick" method wherein the hole is heated mo- 
mentarily with the iron and the toothpick is plunged into the 
hole inunediately. This method is tough on toothpicks, so you 
might want to have several on hand before you start. 

Another quick note, this time on the battery. A battery is a 
battery, right ? Well, maybe, the original installation used a 
lithium cell about the size of a triple-A cell, and a lot of folks 
have used both lithium and silver button cells and holders very 
effectively. The current drain is small, mostly when the com- 
puter is off, and there is a recharging circuit on the board for 
the battery (CR6 & CR7). Because I couldn't find an appropri- 
ately sized battery holder within a reasonable time,(the true 
meaning of reasonable can only be found with a friend at the 
bottom of a bottle of very good wine), I used a holder from 
Radio Shack, which holds 2 AA alkaline cells ( which should 
last almost forever) and has a pigtail (2 wires) to which I 
soldered 2 femaleconnectors (1 each). I also soldered 2 single 
pin connectors into the board at BTl, and used double stick 
foam tape to attach the battery holder to the side of the drive 
cage beneath the motherboard. Next time I remove the mother- 
board, I'll just have to unplug the "battery cables". 

HERE WE GO 

The Z80A-PIO goes in at U35. If there isn't already a socket 
there, (there wasn't on my motherboard) I'd solder in a 40 pin 
socket first. The two diodes go in at CR6 and CR7, the polarity 
is marked on the motherboard, just match up the arrows on the 
diodes with the symbol silk-screened at the location. The 
crystal should be CAREFULLY soldered in at Y4, and the 0. 1 
uF disk capacitor is installed at C54. The remaining 2 disk 
capacitors are for C64 and C65, and the battery is put at BTl. 



The clock chip goes in at U36. 1 also put a socket there and then 
plugged in the chip. 

TAKE NOTE 

This is where you can cure or prevent the random resets. Pin 
23 of the clock chip is the Power-on signal and was originally 
tied high directly. There has been some speculation that the 
high transient appearing here on power-up has been acting as 
a "reset signal" indicating that some buffering is needed. 
That notion is further reinforced by the experiences of others 
who have retrofitted clocks. Borrowing from power supply 
theory, an inline resistor (analogous to a choke) and a capacitor 
to ground (analagous to a filter capacitor) would seem to be 
called for. A 100k ohm resistor and a 1 uF dipped tantalum 
capacitor appear to be appropriate, and in fact do the job very 
well. Advent Products had another solution, involving a volt- 
age regulator circuit using a transistor and a zener diode, but 
this is far more cost effective. 

The "universal" mother-board is not really universal, it would 
appear. The K-2x has an 8 1 -295 and the 84 K-4 and K-4x have 
an 81 184/5 depending on whether you believe the schematics 
or the sticker on the mother-board. The difference is that the 
81-295 has pin 23 tied directly high and the 81-184/5 does it 
through a 1 k ohm resistor (R53) with a 47 uF capacitor to 
ground (C87). It fiirther appears that on the 81-184/5 the 
resistor (R53) is bypassed by a trace. In either case, the 
following assembly will work. 

Find the 24 pin component carrier and solder one end of the 
100k ohm resistor to the saddle above pin 23, with the resistor 
itself lying on the carrier between the rows of saddles, slip a 
small piece of insulation on the other lead and dress it along- 
side the resistor so that it returns to the pin 23 location. In a 
similar manner, lay the 1 uF capacitor between the rows of 
saddles, so that its leads can be run to the saddles above pins 
23 and 12, with the negative lead soldered at pin 12 which is 
ground. Now place the MM58167A IC on top of the carrier 
and solder all legs to the carrier EXCEPT pin 23. Bend out pin 
23 and solder the remaining resistor and capacitor leads to it. 

In the past JDR Microdevices in Los Gatos CA has had all the 
necessary parts for the clock retrofit into "universal" mother- 
board. 

PREVIEWS 

Next time we meet we will build a Personality-Decoder board 
from the ground up, and the following time we'll address the 
'84 video ideosyncracies. Unfortunately, I am not on 
CompuServe yet, nor am I reachable on Internet, so "snail- 
mail' ' or landline will have to do. I can be reached through TCJ 
or at 4000 Norris Avenue, Sacramento, CA 95821. 
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The Z-System Corner 

By Jay Sage 



Regular Feature 

ZCPR Support 

Failsafe Scripts Part 2 



Techniques for Running Unattended 

Part 2: 

The FMATE Analysis Macros 

In my previous column I presented the 
control scripts I developed to allow my 
DOS computer to run a sequence of tasks 
unattended over a long period of time, 
during which the computer might have 
to be rdxwted. As I mentioned, I used 
that approach to carry out a large set of 
complex electronic circuit simulations 
while I was on vacation for nearly a 
month. Although several problems did, 
indeed, arise and require rdxwting of 
the computer, the computer was able to 
pick up quite nicely each time where it 
had left oflf, and a large volume of useful 
results awaited me on my return. 

What I described last time was the addi- 
tions to the AUTOEXEC.BAT file that 
allow a general set of commands to be 
run in a fail-safe mode. This time 1 will 
describe the PMATE (or ZMATE) edi- 
tor macros that made it possible for my 
specific circuit analysis tasks to be per- 
formed with some "machine intelli- 
gence" (that seems to be a newer term 
for what used to be called artificial intel- 
ligence). Specifically, a set of control 
programs analyzed the results of the 
simulations and adjusted a circuit pa- 
rameter automatically to determine the 
margins, that is, the range over which 
the circuit would function properly. Next 
time, in the third installment, I will de- 
scribe the glue scripts that held the whole 
operation together. 

The Extension to DESQview 

Before getting into the main subject 
matter, I would like to make one addi- 



tion to the discussion in the previous 
column. I am a great fan of DESQview, 
a DOS multitasker that is in the spirit of 
Bridger Mitchell's BackGrounder-ii un- 
der CP/M. It is, naturally, much more 
sophisticated and elaborate, but I use it 
mainly the way I use BGii, to switch 
between tasks. It is handy to operate my 
fail-safe system under DESQview so that 
someone can pop into another window 
to examine logs of system activity or the 
results-to-date. 

To boot up in DESQview, I add the 
command "DV" to my 
AUTOEXEC.BAT file. Then I need a 
way to get DESQview to operate in a 
fail-safe start-up mode. To accomplish 
that, I define a special DESQview key- 
stroke macro ~ the one that DESQview 
runs when it first loads ~ as follows: 

{Learn! "!DV Startup"} 

{Enter} 

fs 

{Finish} 

This is the text form of the definition. 
DESQview has a utility to convert be- 
tween the text form and an executable 
form. Even if you don't know 
DESQview, you can probably guess that 
this launches the DESQview task iden- 
tified by the letter pair FS (all DESQview 
tasks have two-character IDs). The FS 
task is set up to run the command 
FAILDV.BTM, the dummy version of 
which is shown in Listing 1. It is basi- 
cally the same as the dummy 
FAILSAFE.BTM that we described last 
time. 

Text Analysis and Automation Using 
PMATE 

We now turn to the main subject of this 
column: the use of PMATE (or ZMATE) 



to carry out an analysis of text that can 
be used to control an automated process. 
The complex set of commands that car- 
ries out the simulation of my electronic 
circuit will be described next time. For 
now I will show only the core set of 
commands where the simulation and the 
analysis of the results take place. The 
following are the two essenUal com- 
mands: 

c:\pspice\pspicel.exe alexsrl.cir alexsrl.out 
edit S b9e xi alexsrl.mat $ .9 

The first command invokes the PSPICE 
circuit simulator on the circuit defmed 
by the file ALEXSRl.CIRand writes the 
output to the file ALEXSRl. OUT. The 
second command invokes PMATE, 
which I have renamed to EDIT, with a 
command Une that nms a MATE macro. 

The macro command passed in the com- 
mand tail first switches to edit buffer 9 
(b9e), then reads in the file 
ALEXSRl .MAT (xi), and finally ex- 
ecutes the contents of ALEXSRl. MAT 
as a macro (.9). Obviously, we have to 
look at ALEXSRl.MAT to see what 
really goes on. It is shown in Listing 2. 
Let's start with an overview of what the 
macro does and why. 

This macro will examine the circuit 
simulator's output hsting, which includes 
a table of voltages at various points in 
the circuit at various times, and deter- 
mine whether the circuit fimctioned prop- 
erly. But how can PMATE then convey 
this information to the world outside 
PMATE, namely to the batch file that 
invoked PMATE and has to decide what 
to do next? 

If PMATE could write to enviroiunent 
variables, that would be a very good 
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way, but PMATE cannot do that. Under 
Z-System we might use ZMATE's abil- 
ity to poke values into absolute memory 
addresses and then use ARUNZ's ability 
to paste the contents of memory into a 
command script to get the result. Fid- 
dling with memory is not such an easy or 
safe thing to do under MS-DOS, because 
one can never be sure of the absolute 
address at which a program will be 
loaded. For that matter, it's probably 
not such a smart thing to do in CP/M 
either. 

A really sophisticated method would be 
to have PMATE compose the text of a 
BTM file and write it out to disk. The 
master script that invoked PMATE could 
follow that command with the invoca- 
tion of the script to be created by PMATE. 
I have done things Uke that on occasion, 
but I chose a simpler approach here. I 
just made PMATE create a file with a 
particular name to serve as a flag or 
semaphore. One file indicates that the 
circuit fimctioned properly, another in- 
dicates that the circuit failed, and a third 
signals some kind of error in the analy- 
sis. The controlling BTM script need 
only test for the existence of these files. 

Now let' turn to the details of the macro. 
The first thing it does is to delete any of 
these semaphore files that might exist 
from before. It first tests for the exist- 
ence of the file using the MATE com- 
mand @Ffilename$, which returns a 
Boolean value of TRUE (-1) if the file 
exists and FALSE (0) if not. If the test 
is TRUE, then the file is deleted using 
the macro XXfilenameS. 

The file ALEXSRl.MAT does not con- 
tain all the information or commands 
needed to perform the entire task, so it 
proceeds to load additional files into other 
editing buffers. The first three will only 
be read; the last one will be edited. 

Into buffer 7, the master macro loads the 
file ALEXSRl.TPL, which contains a 
template that indicates the desired cir- 
cuit response. More about this later. A 
subroutine macro, READNUM.MAT, is 
read into buffer 8. This is a macro that 
I use in many other analyses, and so it 
was convenient to store it in a separate 
file rather than incorporate it into the 



master macro directly. The next step is 
to read the simulation results 
(ALEXSRl.OUT) into buffer 1. 

The last step is to open the file 
ALEXSRl.RES, the cumulative results 
files, for editing in buffer T. Since this 
file grows larger and larger as time goes 
on, it is read in last. That allows PMATE 
to use it automatic disk buffering to scroll 
through the file to the end with the UZ 
macro without risking an out-of-memory 
error condition. If it were loaded earlier, 
PMATE might run out of memory when 
trying to load the other files. That's just 
what happened when I was away in 
Germany. My colleagues described the 
screen displayed by the hung computer, 
and I was able to diagnose the problem. 
I had Uiem copy the large ALEXSRl .RES 
to a floppy diskette and then delete it 
from the hard disk, allowing a new one 
to form. As I recall, they had to do this 
one additional time before I returned. 

Now the analysis can begin. To under- 
stand what is happening, you need to 
know what flie output from PSPICE looks 
like. Listing 3 shows a condensed ver- 
sion. The beginning of the file has a 
complete listing of the circuit definition. 
Only after that come the results of the 
computation. 

The analysis begins in buffer 1, with the 
cursor at the end of the file. We search 
backwards for the string "O.OOOE+00". 
From experience I know that this exact 
value of zero occurs only as the value of 
time in the initial time step. (If that 
could not be relied on, I could have 
searched back for the second occurrence 
of "TIME".) Ifthe search fails, there is 
something wrong with the data file. We 
then go to buffer T and add an error 
message to the result file. We then cre- 
ate a one-line semaphore file, 
ALEXSRl .UNK, to signal an unknown 
result and exit from PMATE. 

Ifthe search succeeded, we loop through 
the output data several times, each time 
looking row-by-row at a particular col- 
umn of data. The circuit is a digital shift 
register, and the data table shows the 
voltages at three stages of the shift reg- 
ister after each clock cycle. We want to 
determine for each voltage whether it 



represents the high digital state, the low 
digital state, or an intermediate, invalid 
state. The circuit can fail either by hav- 
ing a node that does not settle into a 
valid digital state or by having a node 
end up in the wrong digital state. 

Variable 2 is used to store the column 
number where the character 'E' appears 
in the data for a particular node. The 
loop is traversed for column values of 
20, 32, and 44. If an 'E' is not found, 
then we know we have reached the end 
of the table, and we skip out of the loop 
to pick up the next column value. 

Ifthe 'E' is present, we back up to the 
beginning of the number and execute the 
subroutine macro (READNUM.MAT) in 
buffer 8. It loads variable with 1000 
times the value of the number in the data 
table. For my circuit, a value under 800 
(0.8 V) constitutes the low state, and a 
value over 1600 (1.6 V) constitutes the 
high state. Depending on the outcome 
of tiie comparisons, either an 'L', and 
'H', or an T is added to the line in the 
result file in buffer T. 

After each column has been scanned, a 
carriage return is added to the result file 
so that the results for the next column of 
data (shift register node) appear on the 
next line of the result file. A section of 
the result file is shown in Listing 4. 
When the three loops through the macro 
have been finished, the result file will 
end with lines like the following: 

LHLLHHHHLLLL 
LLHLLHHHHLLL 
LLLHLLHHHHLL 

The top line shows the sequence of out- 
put states of the first stage of the shift 
register. The second line does the same 
for the second stage, and so on. You can 
see that the data pattern propagates 
through the shift register. 

The next step is to see if this pattern 
agrees with the intended pattern, which 
we loaded into buffer 7 from the file 
ALEXSRl.TPL, which I had created 
manually. The macro command 
@h'^A@7$ (where '^A represents con- 
trol-A) compares the text at the cursor 
(in buffer T) to the text represented by 
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the indirect string "^A@l'\ i.e., the 
contents of buffer 7. The result of the 
comparison is stored invariable 0, which 
is then tested to determine which mes- 
sage line will be added at the end of the 
result file and which semaphore file -- 
ALEXSRl.GD or ALEXSRl.BAD -- 
will be written out. The edit buffer is 
then closed (macro XE$), and the edit 
session terminated (macro XH). 

Having shown you last time the general 
structure of the failsafe setup and this 
time the iimermost structure where the 
evaluation of the results of a single simu- 
lation is made, next time I will show you 
how these two pieces are connected to 
cany out the complete, complex compu- 
tational task. 



Listing 1 . The dummy failsafe script for DESQview. 

@echooff 

REM This is the initiai FAILSAFE program that will be run 
REM when DESQview is first booted. 

text 

This is FAILSAFE for DesqViewl Right now It is doing 
nothing. Add code to C:\D\AFAILSAFE.BTM if you want 
something to be performed on a coldboot into DesqView. 
endtext 



Listing 2. The MATE macro contained in the file 
ALEXSR1.MAT 

;ALEXSR1.MAT 

; This macro analyzes the data in ALEXSR1 OUT and 
: generates a table of the output states for each of the 
; three latches. The results are compared to a template 
; supplied by the file ALEXSR1.TPL. A flag file is written 
; out to indicate the result of the analysis. These files are: 
; ALEXSR1.GD results were good (matched template) 

ALEXSR1 .BAD results were bad (did not match 
; template) 

; ALEXSR1.UNK results unknown; analysis failed 

; clear any exiting flag files 



bte 

i "* bad data in 

13i 

1xoalexsr1.unl<$ 

xe$xh 

% 

} 

t 
20v2 

:L 



I 

@2qx 

(@t="E)'U 

-5m 

8 

bte 

@0<800{ 

i L$ 

}{ 

e0>1800{ 

i H$ 

K 
i 1$ 
) 
> 

b1e 

1 

bte 

13i 

b1e 

# 

e2+12v2 

e2<45(il) 



bte 

-31 

@h«A@7$vO 

z 

131 

i Results are $ 

eo=o{ 

iCORRECTS 
1xoalexsr1.gd S 

K 

iWRONGS 

1xoalexsr1.badS 

} 

13i 

xeS 

xh 



goto buffer T 
ALEXSR1.0UT"'$ 

write error message 
write flag file 

close the edit file and quit 
end macro (not really needed) 
END IF 

remember the location 

process first column of data 

mark entry point for looping 



; REPEAT 
goto next line 

goto exponent of value to read 
if character is not "E", exit loop 
back up to beginning of number 
read the value into variable 
goto buffer T 
IF result is low state 
write" L" 
ELSE 

IF result is high state 
write" H" 
ELSE 
write " I" 
END IF 
END IF 
return to buffer 1 

; END REPEAT 

; goto buffer T 

; add carriage return 

: come back to buffer 1 

: return to starting point 

; calculate column for next data 

: if less than 45, loop back 

; above is {jl} 

; goto buffer T 
; go back to beginning of output table 
; compare to template, put result in vO 

: back to bottom of file 

; insert blank line 

; insert header text 

; IF results matched template 
insert "CORRECT' 
write out "good" flag file 

:ELSE 
insert "WRONG" 
vwite out "bad" flag file 

; ENDIF 

; finish the line 

; close the edit file 

; end session 



Listing 3. A condensed listing of the output file from the 
PSPICE circuit simulation program. 



•07/22/9213:22:58' 



' PSpice 4.05 * 



{ Listing of circuit definition deleted } 
{ Listing of model parameters deleted } 
TI)«IE V(0UT1) V(0UT2) V(0UT3) 



@falexsr1 .gd$0o(alexsr1 .gd$} : IF alexsrl gd exists, 
@falexsr1 . badS^lexsrl . badS} , IF alexsrl bad exists. 
@falexsr1.unk$^lexsr1 unk$) ; IF alexsrl. unk exists, 

if awicte «racA it 


O.OOOE+00 
2.000E-10 

A^m^-.-^o 


3.059E-01 
5.367E-01 
5 387E-01 


3.059E-01 
5367E-01 
5.387E-01 


3.059E-01 
5367E-01 
5.367E-01 




, 


6.000E-10 


5 387E-01 


5.387E-01 


5.367E-01 


; load support files into buffers 


8.nnnF-io 

1.000E-09 


5 3e7E-01 
5.387E-01 


5.387E-01 
5.3e7E-01 


5387E-01 
5.367E-01 


b7e 

xk 

xi alexsrl tpl$ 


goto buffer 7 

clear it 

load template file 


1.2tX)b-09 


5.367E-01 


5.367E-01 


5.367E-01 


1,400E-09 


5.367E-01 


5.367E-01 


5.3e7E-01 


1.600E-09 
1.800E-09 


5.367E-01 
5.367E-01 


5.367E-01 
5.367E-01 


5.387E-01 
5,367E-01 


bSe ; goto buffer 8 

xk ; clear it 

xi readnum.mat $ ; load the macro for reading numbers 


200OE-O9 


5.367E-01 


5.367E-01 


5.367E-01 


2200E-09 


5.367E-01 


5367E-01 


5367E-01 


2400E.09 


5.367E-01 


5,367E-01 


5.367E-01 


b1e 


work on data in buffer 1 


JOB CONCLUDED 






xk 


clear it 










xi alexsrl outs 


read in the data file 


TOTAL JOB TIME 


1874.95 




bte 


goto buffer T 










xk 


clear it 










xf alexsrl .res $ 


edit the result file 










uz 


make sure we start at the end 










ble 


back to buffer 1 for analysis 










e 


turn off error trapping 










-sO.OOOE+OCS 


find starting time value 










ee{ 


IF error 











Listing 4. A section of the result file ALEXSR1 . RES. 

07-09-92: Timer 1 on: 10:42:04 

tftime = 50ps 
ratio =0.90 
couple =0.22 
ShotArea = 4.00 
Vclk1 = 2.45 
VcIkO = 0.00 
cross = 1 CO 

LHLLHHHHLLLL 
LLHLLHHHHLLL 
LLLHLLHHHHLL 

Results are CORRECT 

Timer 1 off: 11:47:29 elapsed: 1:05:24.70 



07-09-92: Timer 1 on: 1 1 :47:36 

rftime = 50ps 
ratio = 0.90 
couple = 0.22 
ShotArea = 4,00 
Vclkl =2,50 
VcIkO =0.00 
cross = 1.00 

LHLLHHHHLLLL 
LLHLLHHHHLLL 
LLLHLLHHHHLL 

Results are CORRECT 

Timer 1 off: 12:52:04 elapsed: 1:04:27.91 



SCSI BACK ISSUES 

Here is a list of Back Issues that per- 
tain to SCSI. 

#22 - SCSI Introductory Column. 
#23 - SCSI troduction to interface. 
#24 - SCSI command Protocol. 
#25 - Building a SCSI adapter. 
#26 - Sofhvare for SCSI adapter. 
#28 - SCSI for Real Time Control. 
#31 -SCSI for General I/O. 
#33 - SCSI for the S-100 Bus. 
#48 - SCSI/Bemouli Drive for CP/M. 

Issue 20 to 25 available in Volume 3, 
Otherwise all issues available sepa- 
rately. See pages 52/5 Jfor list of back 
issues and how to order them. 
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History 

This is going to be a nostalgia trip. We 
are going to talk about SouthWest Tech- 
nical Products Co. and GIMIX prima- 
rily. 

By way of introduction, I started work- 
ing with microprocessors and their ap- 
plications in 1977. 1 am an electrical 
engineer by education, and I soon saw 
the utility of computers in making my 
job easier. (I must admit that when I saw 
the first press release in a trade journal 
describing a microprocessor, my reac- 
tion was "What would I do with some- 
thing like that?' '). In December of 1976 
I purchased my first computer, a single 
board KIM-1 that used a 6502 proces- 
sor. After learning a bit about instruc- 
tion sets and real machine language pro- 
gramming (i.e. calculate the binary or 
hex instruction and enter it into the com- 
puter memory that way), I decided to go 
a bit further into computers, so I ordered 
a 6800 based computer from SouthWest 
Technical Products Co. (I'll call them 
SWTPc as nearly everyone did for quite 
a few years). I bought the basic com- 
puter kit with processor board and extia 
memory so I could have 16K and could 
run "8K BASIC" with some room to 
spare for programs and data. My order 
was placed in February 1977. 

The order must have hit SWTPc about 
the time a run started. An article had 
just appeared in (I think) Popular Elec- 
tronics about their machine, and they 
must have been swamped with orders. 
The first thing that arrived was a box 
containing the BASIC and some other 
software, and the manuals for those. It 
was June when the fmal parts arrived. I 
had ordered a cassette tape interface, a 



printer, and a "TV Terminal" which 
consisted of a keyboard and a board with 
the serial terminal logic and a signal 
converter so the terminal could use a 
standard TV set as a monitor (It had 40 
character lines, since at standard TV 
resolution 80 characters would not be 
readable. All these were in kit form. 

Before the computer kits arrived, I spent 
many evenings studying the BASIC pro- 
gramming manual. I had managed to 
find a Tiny BASIC fertile KIM-1, and 
to expand it's memory so 1 could begin 
to play with BASIC programs so by the 
time the SWTPc hardware arrived I could 
at least write a simple BASIC program 
and make it work. 

I assembled the kits and had no problem 
with the computer itself, but I managed 
to put a solder bridge on the cassette 
interface circuit board, which took sev- 
eral hours to track down and repair. 

At work, we had seen the potential of 
microcomputers applied to our products 
and had contacted Intel and Motorola. 
The Intel folks told us that we would 
have to spend a lot of money to get a 
development system going. The 
Motorola folks said "We'll be right 
over". Consequently we went with 
Motorola processors, which pleased me 
because I had a nearly compatible com- 
puter at home. We bought the Motorola 
"Exorciser" development system with 
floppy disk drives and software includ- 
ing a klutzy line editor and an assem- 
bler. 

As microcomputer technology grew, I 
eventually bought myself a pair of 5.25" 
floppy disk drives and the SWTPc inter- 
face board for my home system, plus 



their simple operating system at the time. 
I used it for such a short time that I had 
forgotten what it was called. 1 just ran 
across a reference to it. It was FDOS (1 
assume for Floppy Disk Operating Sys- 
tem). It assigned disk sectors sequen- 
tially and space wasn't recovered when 
you deleted a file so you had to mn a 
utility called PACK to move all the valid 
files to the beginning of the disk to make 
room for further ones. (UCSD Pascal 
adopted a similar disk operating system 
that used a PACK utility). 

The hardware disk interface didn't work 
right off, so I sent it back to SWTPc for 
a fix. It was returned promptly and in 
good working order. A few months later 
the mailman nicely folded a 9 by 12 
envelope in half and stiiffed it in the 
mailbox. It was a manual and floppy 
disk containing Miniflex from SWTPc. 
I managed to unfold the floppy enough 
so I could read it, and I had Miniflex 
installed in no time. 

I remember the first assembler and my 
fears about using it, which were quashed 
in a day or so after I started to experi- 
ment witii it. The TSC editor was a 
"line editor" in which you entered a 
line number and that line was printed on 
the terminal. By various commands you 
could edit a Une. C/this/that/ for ex- 
ample changed the first occurrence in 
the line of the word "this" to the word 
"tiiat" . C/about// would delete the first 
occurrence ofthe word "about" etc. The 
slashes were string delimiters and others 
would work as well. If you wanted to 
edit a slash, for example, you could use 
dashes for delimiters. 

When the 6809 processor became avail- 
able SWTPc sold a new processor board 
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with a 6809 on it. I bought one and 
modified my motherboard to decode 
addresses more tightly. Since I had so 
much old 6800 software and so little for 
the 6809 1 installed a switch that would 
allow me to use either processor board. 
There were some differences in the ad- 
dress decoding and the switch could 
accomodate either. With that upgrade 
came FLEX9 for the 6809. Flex was a 
product of a company called Technical 
Systems Consultants, then in Lafayette 
Indiana (Purdue country). They had sold 
a number of computer games written in 
assembler and distributed on cassette tape 
for the 6800, and then branched into a 
line editor, an assembler, and a number 
of other products. Now as I think about 
it, they sold some simple games for the 
KIM-1 6502 board as well on cassette 
tape or in source and object code listing 
form. Of course computer games in 
those days were things like "Hangman". 
The most complex game they sold was 
"Battleship", just like the old board 
game in which your opponent tries to 
sink your ships secretly marked on a 
grid, by bombing various points on the 
grid. 

TSC was the firet major supplier of soft- 
ware for the SWTPc systems, though 
SWTPc dabbled in software on and off 
as well. TSC released two versions of 
BASIC to replace the original SLOW 
BASIC that used BCD arithmetic. The 
first release had 6 digit arithmetic and 
was FAST. The later one had 15 digit 
arithmetic and was slower but still faster 
than the old nine digit BCD version. 
BCD means "Binary Coded Decimal". 
Most of the 8 bit processors had some 
facilities for decimal arithmetic in which 
a byte was divided into two 4 bit 
"nibbles", each one representing the 
numbers through 9. Since in binary 
each 4 bits can represent numbers 
through 15, BCD is a less efficient rep- 
resentation of a number, but more im- 
portantly, binary arithmetic is more natu- 
ral on a system in which numbers are 
represent^ in binary. More natural 
means more efficient. Binary arithmetic 
runs much faster than binary coded deci- 
mal. 

I began to write a column for '68' Micro 
Journal after dabbling in publishing a 



newsletter that 1 advertised by letters to 
the editor of Kilobaud and a couple of 
other computer publications of the time. 
My first column appeared in the June 
1979 issue. I seemed to have a knack for 
finding bugs in new software. TSC's 
BASIC wouldn't properly REWIND a 
data file, for example, and their new 
FLEX version of the assembler had a 
bug that showed up when I typed in their 
first 5 line example program. 

Those first floppy drives were pretty 
unspectacular. Each disk was single 
sided and single density, andtheShugart 
drives were capable of 35 tracks (40 
tracks, 80 tracks, double sided, and 
double density all came later). One track 
was taken with boot information and 
directory, so the disk had 34 user tracks 
with 10 sectors of 256 bytes each, four 
of which were used for sector linking. 
Total bytes per disk were therefore 252 
times 10 times 340 = 85,680. Since my 
computer at the time had 32K of memory 
(I had expanded it when I could buy a 
16K board for around $190), I won- 
dered how I could ever fill a disk that 
held that much data(!) At the time I was 
writing a few utiUties in Assembler, and 
most were no more than IK bytes, four 
sectors or less, so 85K plus sounded like 
a lot of room. Early SSSD (Single Sided, 
Smgle Density) disks cost nearly $5 each 
for this single sided single density 
appUcaton. (I now buy them by the 
hundred in DSDD pouble Sided Double 
Density) version for about 30 cents each). 

Of course I soon wanted a third drive. 
The best I could do at that time was 
another 35 track drive for the bargain 
price of $225. Then came double sided 
40 track drives holding around 200K, 
double density, giving 18 sectors per 
track, allowing 360K, 80 track drives 
at 720K. I was still back at the 85K 
drives when I bought a pair of 8 inch 
floppy drives that were double sided and 
double density, and held just under 1 
megabyte of data. Wow, 12 smaller 
disks worth on one large disk. I would 
surely never need more than my original 
box of 10 disks (Ha). Incidentally those 
drives cost $425 each and the controller 
was around $225. One drive cost more 
than the original computer kit! (Last 
week I bought a 1 70 Megabyte hard drive 



for $209. I had the IDE controller, but 
could have bought one for $17)! I also 
bought an Integral Data Systems printer, 
a simple 9 pin dot matrix with one draft 
mode and friction feed for roll paper. It 
marked page ends (at least some of my 
software did that) but pages were some- 
where between 9.5 inches and 1 1 inches 
long due to friction feed variations. 

The new 6809 processor boards had what 
was called a Dynamic Address Transla- 
tor memory management scheme. The 
DAT managed four extra address bits, 
and so could address I Megabyte of 
memory. FLEX couldn't manage more 
than 64K, however, so along came a 
bigger version of FLEX called UNIFLEX 
to handle that. I didn't ever get into 
Uniflex. 

All along a company called GIMIX in 
Chicago had been seUing competitive 
hardware, undoubtedly higher quality 
better designed and better tested equip- 
ment at substantially higher prices than 
SWTPc, but unfortunately also incom- 
patible with respect to disk formats. The 
stoiy was that SWTPc, in order to save 
one IC package on their disk controller 
board, had used the density byte to in- 
dicate which side, and the side byte to 
indicate single or double density. It all 
worked fine if you had a SWTPc system, 
but if you wanted to swap files with 
someone with a GIMIX system you had 
to use a single sided single density disk 
only. GIMIX FLEX was different too, 
since the GIMIX ROM monitor soft- 
ware was different and the disk control- 
ler hardware had to be different. In all 
fairness, GIMIX did it per the IBM 
standards for floppy disks, correctly 
using the density and side bytes on the 
disk. 

I received a letter fi-om Terry Ritter, one 
of the designers of the 6809. He was 
very unhappy for two reasons. The first 
was that the 6809 didn't have extended 
memory management built-in. Because 
of that, each manufacturer handled the 
extended memory management differ- 
ently, so software written for one 
wouldn't work on the other. This fi-ac- 
tured the software market so that differ- 
ent versions had to be written for each 
kind of machine. A company called 
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Smoke Signal Broadcasting Co. was 
also selling 6809 machines at the time, 
and they required yet a different operat- 
ing system. (I have to say that I never 
saw one of their computers so I don't 
know much about them). Anyway, Teny 
felt that the disparity of extended memory 
management schemes spelled the death 
of the 6809. He didn't say it, but I think 
he feh that was why IBM chose the Intel 
8086 with it's built in memory manager. 

Terry also felt that the software lagged 
the introduction of the 6809 by much too 
long. The combination of the fractured 
market and the delays were what, in his 
opinion killed the 6809. Actually there 
was quite a bit of 6809 software devel- 
oped for the SWTPc hardware. Looking 
back, I think most of it was done by 
individuals out of necessity because they 
needed it, as a hobby, learning experi- 
ence, or whatever, the making of money 
being the lowest priority. The market 
never really got big enough to be able to 
support a company that supphed one or 
two software products. The closest thing 
to a commercial effort to supply software 
was TSC with numerous products. At 
one time or another they sold their stan- 
dard Assembler, a relocatable macro 
assembler, Pascal compiler, two BA- 
SIC interpreters, a front end processor 
for BASIC that let you write code that 
didn't look like BASIC, a line editor, a 
word processor (reasonably powerful), a 
super debugger in both 6800 and 6809 
versions (for drugging assembler soft- 
ware), a math package, a scientific fimc- 
tion package, and undoubtedly a few that 
have escaped my attention. Oh, yes, 
eventually they released a version of 
FLEX that would run on a Motorola 
Exorciser system, their original ' 'indus- 
trial" development system for 6800 soft- 
ware. 

Many of the suppliers advertised their 
products in '68 ' Micro Journal which 
became the hub of information on hard- 
ware and software for FLEX and the 
6809. I wrote my column in that publi- 
cation for ten years plus, and never re- 
ceived payments in the form of money, 
but because I could write a review of a 
software package at least somewhat ob- 
jectively, I became the software reviewer 
and applications ' 'explainer' ' . 1 received 



a copy of every software package that 
was developed for those systems over an 
extended period of time. Some of it was 
downright junk and some was eminently 
usable. I was always free to express an 
opinion either way (or I wouldn't have 
continued writing columns). A few of 
my reviews were not published, and the 
package given to someone else with a 
difierent outlook than I, and in some 
cases received a better review. I can't 
complain about that because I looked at 
tools from a perspective of whether they 
would be usefiil to ME or not. I could 
never becomeso detached and objective 
that 1 could simply praise a software 
package because it ran as advertised and 
was relatively bug free. I do remember 
one C compiler that tested a real number 
for zero by adding up the bytes of the 
mantissa and testing the sum for zero. 
Carry was ignored, and so many combi- 
nations tested zero when they really were 
not. Of course the proper test would 
have been to OR all the bytes together 
and I made that suggestion. 

A package came along called PIE 
(Programma Interactive Editor) by a fel- 
low named Tom Crosley at a company 
called SoftWest. Tom had done a 6502 
version for (of course) the Apple (known 
as Apple PIE). He had done a 6800 
version and a 6809 version. PIE was a 
fiiU screen editor and I liked it a lot. I 
managed to get the source code so I 
could customize it for different termi- 
nals. It was written in Assembler, not 
very well modularized. I decided that I 
would prove to myself that I could write 
a similar one keeping the good features 
and adding better ones, in a higher level 
language. A company called Windrush 
Microsystems in the UK had produced a 
compiler called PL9, which was almost 
Pascal, but allowed some things that 
Pascal wouldn't. I embarked on a year 
or two spare time project to write a saeen 
editor called PAT. PAT stands for Pro- 
gram And Text Editor. 1 thought PATE 
sounded too much like liver, so I dropped 
the E. I don't know why I didn't think 
of calling it TAPE, I still use PAT on 
my 6809 systems. 1 wrote a version in 
C and then in Windrush's PL9 version 
for the 68000 called plus. The C version 
ran under 0S9 on a 68020 system that 
used GIMIX hardware. The plus ver- 



sion ran under SK*DOS on a 68000 
system supplied by Peripheral Technol- 
ogy. Later I did a C version for IBM, 
which I am presently using to write this. 
(Yes, I've switched at least part of the 
time to IBM clones). 

One evening I was busily using a 
disassembler called DYNAMITE to look 
at the code in PIE. When my son asked 
me what I was doing, I said without 
much thought "I'm disassembling PIE 
with DYNAMITE". Of course it sud- 
denly occurred to me that such an opera- 
tion would be pretty messy! 

At work we had long ago bought a few 
SWTPc systems to use for program de- 
velopment, and then eventually built our 
own. As soon as we started program- 
ming our machines in Assembler I started 
searching for something else. I figured 
we couldn't write programs fast enough 
in assembler. I ran across a compiler 
called STRUBAL+ (STRUctured BAsic 
Language) by Jack Hemmenway. It 
worked, but it was terribly inefficient. 
A four page program would run me out 
of operating memory on the 6800 sys- 
tem. Lucidata in the UK advertised a 
Pascal compiler and it worked just fine, 
and was reasonably eflScient though it 
wasn't very fast because it was a P code 
compiler. That is, it generated a pseudo 
code that had to be interpreted at runtime. 
It was very easy to use, and was bug 
free. I reviewed it and called it the first 
non-toy compiler I had seen for the 68XX 
processors. Windrush PL9 appeared soon 
and I reviewed it saying that I would use 
it if only it had floating point arithmetic. 
A couple of months later I received an 
update package with floating point arith- 
metic, and we started using it (and are 
in fact STILL using it since we still build 
and ship computers with 6809 proces- 
sors). 

Assuming that some of you readers have 
old 6809 systems of GIMIX or SWTPc, 
and realizing that you might be looking 
long and hard for software, let me list 
the last known addresses of some of the 
software suppliers. Perhaps if a few are 
still in business and enough of you in- 
quire about certain products, they will 
run off a few copies and manuals and 
sell them to you. If you write them and 
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find out they are no longer interested in 
selling copies, you might ask if it is OK 
to get a copy from someone that has their 
software. I understand that most of the 
suppliers have been quite unreasonable, 
not wanting to supply the software but 
still maintaining Ml copyright protec- 
tion, thus making it impossible to get a 
copy. Maybe there are a few who now 
are willing to allow vintage computer 
users to share vintage software. My best 
hunch would be that Windrush would 
approve, and perhaps Lucidata. TSC 
may not be in business, and some of my 
last known addresses might be wrong, 
or tlie companies out of business. 

If you get approvals for public domain 
release of some of the software the 
chances are good that I have a copy 
somewhere. I'll be glad to supply copies 
to someone wanting to act as a librarian, 
but manuals will be a big problem. Maybe 
in these days of quick copy places, some- 
one will want to copy them and distrib- 
ute software and manuals for cost plus a 
small profit to cover wear and tear on 
disk drives etc. I'll donate originals if I 
can have a set of copies back. All this 
contingent of course on a duly signed 
authorization to allow vintage computer 
users to swap copies. 

Perhaps that is enough for a first col- 
umn. If you care to write me, my full 
address is: 

Ronald W. Anderson 
3540 Sturbridge Ct. 
Ann AfboT, MI 48105 

Please, if you want to communicate, write 
and don't call. I like to answer letters 
and questions at my convenience, gener- 
ally late at night when all is quiet around 
the house. I don't promise to answer 
every letter either in column form or 
personally, but I have in the past gener- 
ally managed to do so. It will depend a 
bit on whether I get 5 letters or 100. I 
type fast and enjoy corresponding with 
someone as a change of pace from my 
work use of computers. Please don't ask 
me to send you software. We must go 
through the public domain release pro- 
cess first. There is one exception. I'll 
send source and object code to PAT 6809 
version (I'm sorry but there is no 6800 



version) along with a complete manual 
on disk (that can be printed out on any 
standard dot matrix printer) to anyone 
who will send me a blank disk. Format 
will be DSDD 40 track, FLEX (not 
GIMIX) compatible. If you have a 
GIMDC system I can send PAT on a 
couple of SSSD disks and you can copy 
them to a DSDD on your system. Please, 
if you want PAT, send blank disks and 
desired format instructions. 

I should mention here that though FLEX 
is no longer available and last I heard 
TSC wasn't willing to let it go Public 
Domain, there is a totally compatible 
operating system called SK*DOS avail- 
able from Peter Stark (see below). 
SK*DOS will run any software package 
that would run under FLEX. 

Addresses: 

Windrush Microsystems Ltd. 
Worstead Laljoratories 
North Walsham, Norfoll< NR28 9SA 
United Kingdom 

PLUS - Pascal like language for 68000 0S9 
PL9 - Simitar language for 6809 FLEX 
MACE - 6809 macro assembler 
McCosh "C" - a fairly complete C compiler 
(pre-ANSl) 



Star K Systems 
P.O. Box 
Mt. Kisco, NY 
Peter Stark 

SK'DOS operating system for 6809, FLEX 

compatible 

SK*DOS for PT-68K 68000 systems 



Lucidata Ltd. 

(last known address, 1986) 

P.O. Box 128 

Cambridge, CB2 5EZ 

England 

Nigel Bennee 

P-6800 Pascal Compiler for 6809 FLEX 



Certified Software Corp. 
P.O. Box 70, 
Randolph, VT 05060 
Bob Reimiller 

Pascal compiler for 0S9 680XX 

Pascal compiler for FLEX 6809 (long ago) 



Palm Beach Software 
12364 CR 223 
Oxford, FL 34484-2709 
Dan Farnsworth 

SPELLS - 6809 spelling checker FLEX 

SPELLS - 68000 spelling checker SK'DOS, 

REXDOS 

ASMK - 68000 Assembler SK*DOS, 

REXDOS 

REXDOS - operating system for 68000, 

FLEX compatible 

EDDY - screen editor for 6809, version 

for 68000 

68000 in this context Is PT68K-2, -4, -5 from 

Peripheral Technology, Marietta GA 



Talbot Microsystems 

1927 Curtis Ave., 

Redondo Beach, CA 90278 (1986 address) 

Ray Talbot 

Another address from a software package: 

Taltx)t Microsystems 
7209 Stella Link, Suite 112 
Houston, TX 77025 

tFORTH for 6809 FLEX version 



Frank Hogg Laboratory (I don't have a cun-ent 
address) 
Syracuse, NY 
Frank Hogg 

FORTH - for FLEX 6809 CoCo 

Currently into 680XX hardware and software 



Lloyd I/O 
19535 NEGIisan 
Portland, OR 97230 
Frank Hoffman 
(may be out of business) 

Line of cross assemblers to run under FLEX 

6809 

and OS/9 68000 

Introl Corp. 

647 W. Virginia St. 

Milwaukee, Wl 53204 

C compilers for FLEX, 0S9, and Uniflex 

Mike Randall 
32 Upland Road, Kelburn 
WELLINGTON 5 
NEW ZEALAND 

Modula 2 compiler for SK*DOS 68000 



If anyone has additions to this list, please send 
them to me. I had several other compilers and 
related products from companies or individuals 
that would now be very hard to locate. 
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32-Bit Systems 

All Readers . 

Linux & Linking 



Real Computing 

By Rick Rodman 



Linux 

I installed Linux on CD-ROM (from 
Walnut Creek CD-ROM for about $60). 
The machine I installed it on was a 386 
with 16MB of RAM, a SCSI hard drive 
that I wanted left alone, a SCSI CD- 
ROM, and an external SCSI 128MB 
magneto-optical drive. What 1 hoped to 
do was install it on the magneto-optical. 

Let me s^ right away, this system is 
amazing. The floppy boot which comes 
with the CD , automatically detected the 
Adaptec SCSI board and all of the SCSI 
drives, and the Western Digital Ethernet 
card, and configured itself for all of them, 
without me telling it anything! This is a 
first for the PC worid. 

Linux comes with TCP/IP, X Window, 
Ghostscript, and everything else you 
might need, including full source. It 
also comes with an 85-page manual, 
which is not a "DOS for dummies" by 
any means, but more a collection of pieces 
of terse text files and E-mail messages. 
You can install it in three ways: CD 
dependent, which requires the CD to 
run, but takes only 2MB of hard disk; 
binary, which runs from the hard disk, 
presumably faster, and takes 95MB; and 
complete, copying eveiything to the hard 
disk, which takes 245MB. 

At first, I couldn't get Linux to work 
with the optical drive, either as a single 
partition or split into four. After that I 
tried an 80MB Seagate hard drive, and 
that didn't work either. As it turned out, 
I got bit by the usual Fundamental Thing 
They Forgot to Mention (FTTFM). 

In this case, the FTTFM was the fact 
that there are two different types of par- 



titions - Minix and ' 'Extended", which, 
of course, has nothing to do with the 
Extended DOS partitions you normally 
see hanging aroimd disk partition pro- 
grams. Furthermore, there are also two 
types of filesystems, Minix and Extended. 
Minix filesystems only go in Minix par- 
titions, and Extended filesystems only 
go in Extended partions. Finally, and 
the killer, although you can create either 
kind of partition during installation, the 
installation only lets you run "mkefs", 
and it ai^)ears that this program only 
works with an Extended partition. I 
imagine the "e" in the middle was sup- 
posed to clue me in. 

Once you get it installed, you have to 
make a boot floppy. The instructions are 
on page 2 of the manual, but like much 
of the manual, they're incomplete and 
don't match the actual version of the 
software installed. On my system, /dev/ 
fdO almost works, but doesn't. I have to 
use /dev/fdOH1440 for the floppy. 

1 . Log in as root (no password required). 

2. Format a blank floppy with: fdformat /dev/ 
fdOH1440 

3. Mount the system partion, which in my 
case was the second SCSI drive, PUN 2: 
mount -t ext /dev/sdb1 /mnt 

4. Copy the file vmlinux over the floppy: dd 
if=/mnt/vmlinux of=/dev/fdOH1 440 

For those not familiar with Unix, dd is 
a wonderful utility which can copy files, 
truncate files, translate from EBCDIC to 
ASCII, and a lot of other really neat 
things. You can't just copy, as in "cp / 
mntATnlinux /dev/fdOH1440", because 
the cp command will overwrite the " spe- 
cial file" in the /dev directory which 
represents the device. (Devices are not 
actually files in the /dev directory; in- 
stead, there are "special files" created 
by mknod which represent them for com- 



mon activities.) In the case of character- 
mode devices (e.g. /dev/ttyO), cp seems 
to work properly, but it doesn't handle 
block-mode devices such as disks or tape. 
Dd is more intelligent, but of course is a 
more complicated program. 

Now, once you've booted on the hard 
drive, you may want to get back to the 
CD-ROM. The moimt command you 
need (not Usted in the manual) is: 

mount -t iso9660 /dev/scdO /mnt 

Once you're over those hurdles, you're 
up and ruiming, and you can edit with 
Emacs, compile programs, and anything 
you might do with Minix. But wait, 
there's more. Now, you can move on to 
getting X Window (never "X Win- 
dows", remember!) to work. Nearly all 
VGA and Super VGA boards work very 
well. For higher resolutions, you might 
check what "dot clocks" your video 
board has. I used both ATI and Paradise 
chip-set Super VGAs with no difficulty. 
Diamond boards are not supported. 
There is an experimental driver for the 
8514, which I hope to try soon. 

Side comment to anyone in the PC worid 
wondering what video board is the best: 
There are three basic classes for sale 
today. First, the VGA and Super VGA 
boards. There are slight differences in 
speed among these. Second, the 8514 
and compatibles, such as the ATI Ultra. 
These are tremendously faster than any 
VGA or Super VGA, but cost more. 
You're usually limited to a maximum 
1024x768 resolution. Third, proprietary, 
and very expensive, higher resolution 
boards like Cornerstone, Artist Graph- 
ics, Number Nine, Sigma, Matrox, etc. 
These boards are useful when you want 
to go 1600x1200 or higher. But remem- 
ber, you have to get drivers from them. 
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If the board only comes with a Windows 
2. 1 driver, you run Windows 2. 1 or you 
run DOS, buddy. 

If you try a driver and the screen goes 
haywire, remember that you can get out 
"blind" by a Ctrl-Alt-Backspace 
tridigitation. 

The mouse drivers are more of a mess. 
A Microsoft-compatible mouse con- 
nected to a regular serial port works; 
nothing else I've tried does, though, and 
the manual's comments on this topic 
don't match the installed software. 

X Window is very nice, although it seems 
a Uttle sluggish. There is an MPEG 
viewer which will give your video board 
a real workout. Full source is on the CD, 
too. 

I haven't yet tried the networking stuff. 
Supposedly it's TCP/IP. Also, you can 
apparently mount DOS diskettes and 
partitions, and run DOS programs from 
within Linux, but I haven't tried that 
either. 

The version number of the Linux pack- 
age I got was 0.99.7a, which indicates 
that the folks don't view it as a finished 
system yet. In my opinion, the main 
area that woric is needed in is the manual; 
eveiything else is very good. If you're a 
fairly competent Unix user, there's no 
need to pay big bucks for BSD-386, 
UnixWare, or Solaris. This package is 
more complete, lower in price, and in- 
cludes source. 

Some folks are working on porting Linux 
to the PC-532. I've also heard that a 
port is underway to the Amiga. I'm sure 
you'd need an Amiga with an MMU, 
like the A2000 or A3000. If you've got 
an AlOOO or an A500, you can still run 
Minix. More interestingly, some Linux 
folks are working on a package called 
WINE, which will allegedly allow MS- 
Windows programs to run under Linux 
using X-Windows. This more or less 
resembles the WABI stuff going on at 
Sun, where they hope to run MS-Win- 
dows programs under Motif. 

If you're not fairly confident of your 
Unix thinkology, Minix has a much bet- 



ter manual, and, from what I've heard. 
Coherent is even smoother to get work- 
ing. But if you want to jump in with 
both feet, Linux is an immense package 
with new things to see at every turn. 
And you can't really foul it up too bad, 
because after all, it comes on CD-ROM. 



Dynamic linking in Windows and 

OS/2 

Don't turn the page! What I'm going to 
describe here, and very briefly - 1 prom- 
ise! - is the way the DLLs really work, 
which is much simpler than the 
ponderosities purveyed by PC 
pontificators would presume to portray. 

DLLs really are regular EXE files with 
a list of fiinction entry points at the be- 
ginning. When you load a DLL, it's 
brought into memory. You can now call 
the entry points by indexing into the list 
of entry points. There are two ways to do 
this: by indexing into the table by num- 
ber (called an "ordinal") directly, or by 
looking up the ordinal in a list of names 
near the beginning of the file. 

The SDK, and Windows and OS/2, let 
you use DLLs sort of hke regular code 
libraries. What happens here is that you 
actually link with a "stub library" cre- 
ated by reading the name hst out of the 
DLL. LINK then marks your EXE file 
with a list of DLLs that must be loaded 
before the program can run. As you can 
see, there are bad sides to this: not only 
does your program take a long time to 
start up, as all of the DLLs you ever use 
are loaded, but also, if any DLL doesn't 
exist, your program can't handle it. 

It's faster and more powerftil to load 
your DLLs yourself at mn-fime and call 
the functions using the ordinals. A neat 
capability you get this way is selecting 
the filename of the DLL at run-time, for 
example, to select different languages or 
equipment configurations. 

When you dynamic-link, nothing is 
checked - it's all up to you to get your 
ordinals and parameters correct. If you 
statically link and use prototypes, you 



can be fairly safe, as long as the DLL 
doesn't change - more on this in a minute. 



Dynamic linking in AmigaDOS 

At the outset let me quickly say that the 
' 'DOS" in AmigaDOS doesn't stand for 
' 'Dumb Old Stuff ' hke it does in the PC 
worid. AmigaDOS is a very clever and 
well-designed multitasking operating 
system once known as Tripos. It was 
once portable, but with its destiny chained 
to the Amiga star, hardware dependen- 
cies have slowly crept in. 

On the Amiga, there are "libraries" 
which work very much like Windows 
DLLs. They are executable files with 
multiple entry points. Libraries are 
loaded with a procedure called 
OpenLibrary, which retiuns a pointer in 
register A6. After that, you call the 
library by offsetting from register A6, 
like this: JSR _LV0xxx(A6). Rather 
than using hard-coded constants, usu- 
ally include files are used to define the 
offsets. This gives you the convenience 
of using nmemonic names rather than 
numbers, but it's still much like the 
"ordinals" method under Windows. 

Like Windows, parameters and offsets 
are not checked. If you make a mistake, 
or if the library changes, you're lost in 
space. 

Unlike Windows, which itself consists 
of three main DLLs (named EXE), 
AmigaDOS itself consists of a large 
number of libraries loaded at boot time. 
It's quite easy to add a new device driver, 
or replace any of the standard device 
drivers or libraries. It has its own idio- 
synaasies, of course, but is on the whole 
a very likable OS. It's mulfitasking, too, 
and quite stable. 



Dynamic linking in SunOS Unix 

Under SunOS, the dynamic linking fea- 
ture is considerably different from Win- 
dows and the Amiga. All references are 
done using names (symbols). When you 
have linked with the "shared object" 
library (a " .so" file), a reference is added 
to your object that the file is needed. At 
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run-time, the ".so" file is loaded before 
your program begins execution, but the 
addresses you reference are not resolved 
until the time of first call. This means 
that the first time you call a fiinction, the 
name is resolved in the library. Thus, 
you can get an "undefined symbol" er- 
ror in the middle of running a program. 

Remember the library-changing prob- 
lem we discussed in the Amiga and 
Windows environments? While some 
programmers are writing programs that 
call libraries, other programmers are busy 
making improvements to the libraries. 
With static linking, the program was 
combined with a snapshot of the library 
at the moment that they got along nicely. 
With dynamic linking, neither the rock 
nor the hard place are fixed in any rela- 
tion to each other. 

SunOS, though, has an interesting solu- 
tion to this problem: version numbers, 
with a major version and a minor ver- 
sion, are stamped on the ".so" file and 
any executable it is linked with. Then, 
at run time, the loader (Id. so) looks for 
a ".so" file with the same major version 
number and the maximum available 
minor version number. Library writers 
must remember to increment the major 
version number any time changes in 
fimctions or their parameters are made. 
The version numbers are put on the file 
name. For example, the Xt (X Window 
Toolkit) library file on my system is 
"IibXt.so.4.10", and the C runfime li- 
brary is "libc.so.1.6". 

Unix folks have the luxury of 31-or- 
more-character filenames. Under DOS, 
this same thing would be harder to ac- 
complish. The main drawback of the 
SunOS approach is the linking of entry 
points by name at run-time, which is 
slow; since the library name is deter- 
mined at link time, again, you can't 
handle a missing library or specify the 
library filename at run-time. 

For operating system hobbyists, the best 
scheme - where best means simplest and 
fastest at runtime - appears to be a vari- 
ant on the AmigaDOS system; but add- 
ing the version number scheme used by 



SunOS would be easy to do and well 
worth the extra work. 



TCP/IP for small computers 

Moving along to another topic: What 
we really need in our httle-machine com- 
munity is a consistent way to communi- 
cate between the machines, share files, 
and so on. In my Laboratory, I have an 
Amiga, a DEC Rainbow, four PCs, three 
S-100 machines, and a Sun, in alpha- 
betic order. Many TCJ readers, includ- 
ing our esteemed Editor, have similar 
collections. Right now, to transfer files, 
I have to plug and unplug cables and use 
a variety of file-transfer programs: Kermit 
here, Xmodem there, Zmodem there. 
Wouldn't it be great if we could con- 
struct a little network using RS-232 
cables, with very simple client software 
and consistent commands? 

Since TCP/IP appears to be the standard 
and everyone's favorite, we're looking 
at that first. There are two possibilities 
for TCP/IP on small computers. Both 
support use of SLIP (Serial Line IP), 
which should allow computers with se- 
rial ports to interact with other comput- 
ers on an Ethernet network. 

One is the KA9Q package by Phil Karn. 
This package started out (relatively) 
small and simple but soon became ex- 
tremely large and complex. I have two 
versions, one from 1987, the other from 
1991. The 1987 version has 73 source 
files adding up to 387 kbytes; the 1991 
version has 246 source files adding up to 
1 .7 megabytes. This is not including the 
drivers. 

The second is TNET, an implementa- 
tion of TCP/IP for Minix by Michael 
Temari and Fred Van Kempen. This 
one is not quite as large as the 1991 
KA9Q, but still sizable. 

Actually, I don't think that these pack- 
ages are suitable for our network of small 
computers. They're just too large and 
complex. But that's because TCP/IP 
itself is too large and complex. 

I am quite fond of ftp's ease of use. Ftp 
is an application, however, not the pro- 



tocol it rides on. As an API, I'm com- 
fortable with Netbios, although it could 
have been cleaner. But again, it actually 
says nothing about the protocol under- 
neath. 

What we might do here is design a very 
simple underlying protocol, perhaps 
based on Xmodem or Zmodem, then 
build an API atop that, and an ftp-like 
program atop that. The protocol should 
support forwarding of packets. The pro- 
gram should be usable on single-tasking 
machines with only a single serial port. 

In the computer world a trend has devel- 
oped toward simplicity, streamlining, low 
overhead. An example is the low-over- 
head Frame Relay protocol that is re- 
placing the baroque X.25 . And much of 
the attractiveness of RISC machines 
comes from this same trend. 



Next time 

I've also acquired an experimental oper- 
ating system called "Sprite". This sys- 
tem was designed from the outset as a 
distributed operating system. If time 
and space permit, I'll have some impres- 
sions of that package. 

And from another time and space comes 
a "fully operational battle station", 
Windows NT. Will all else go the way 
of Alderaan? In the meantime, send in 
your NT puns. (For example, "is the 
glass half fiill or half NT".) 



Where to call or write 

BBS or fax: +1 703 330 9049 

(autoswitching) 

E-mail: rickr@virtech.vti.com 

Walnut Creek CD-ROM +1 800 786 
9907 or +1 510 947 5996 
1547 Palos Verdes Suite 260 
Walnut Creek, CA 94596-2228 
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CONNECTING IDE DRIVES 



by Tilmann Reh 



Special Feature 

Intermediate Users 

Part 3: IDE Commands 



In Part II (printed in the previous issue of TCJ) we covered the 
basics of the IDE interface in terms of history, concept, hard- 
ware, and register structure. This time we want to dig deeper 
into the software side of those drives. 

Terminology 

Using common terminology, I often simply refer to the ' 'drive' ' 
when, in feet, I am thinking of the integrated controller of an 
IDE drive. However, when explicitly talking of an external 
controller like the WD 10 10, 1 always refer to the "controller". 

Register Accessing 

Let us first recall the Task File. It consists of the data register, 
a set of six parameter registers, and the command/status reg- 
ister. For those who don't have Part II lying nearby, here is a 
shortform: 



Relative Address Register 



Abbr. 



Data Register 

1 Error Reg. / Write Precomp. Reg. 

2 Sector Count 

3 Sector Number 

4 Cyhnder Low 

5 Cylinder High 

6 SDH (Sector Size, Drive, Head) 

7 Status Reg. / Command Reg. 



D 

E/WP 
SC 

SN 
C 

c 

D,H 



Also remember that the data register is the only 16-bit register! 

Every parameter register of the task file is freely accessible as 
long as there is no active command. Before loading the com- 
mand register, all related parameter registers must contain the 
appropriate values. They may be loaded in any order. After the 
command register is loaded, the issued command is immedi- 
ately started. The original WD 10 10 hard disk controller chip 
had a flag (bit 1 of the status register) which was set during 
execution. With IDE drives, the BUSY flag of the status reg- 
ister is simply set until the command execution is completed. 

The WD 10 10 controller chip knew only 6 commands. How- 
ever, some of the commands have option flags within them. To 
support additional features, today's drives have many more 
commands. The following is a list of common commands, 



options, and needed parameters, with the WD 10 10 commands 
marked by an asterisk and the manufacturer-dependent expan- 
sions marked with a plus sign: 

Command Type 76543210 Hex Parameters 



Recalibrate * 

Read Sector * 
Write Sector * 
Scan ID / Verify ♦ 
Write Format * 
Seek ♦ 

Exec Diagnostics 1 
Set Drive Parameters 1 
Read Multiple + 1 
Write Multiple + 1 
Set Multiple + I 
Power Commands+ I 
Read Sector Buffer I 
Write Sector Buffer 1 
Identify Drive 1 

Cache On/Oflf + I 
Power Save + 1 



I (Rate) 
1 OMLT 

I 1 OMLT 

1 OOOOOT 
10 10000 
1 I 1 (Rate) 
00 10000 

00 1000 1 
1000 100 

1 000 I 1 
I 000 I 1 
I 1 OOxxx 
I I 00 I 00 
110 1000 
1 10 I 1 00 
1 10 I 1 I 1 
1 1 I I XXX 



lO-IF 

20-27 

30-37 

40,41 

50 

70-7F 

90 

91 

C4 

C5 

C6 

E0-E6 

E4 

E8 

EC 

EF 

F8-FD 



D 

SC,SN,C,D,H 

SC,SN,C,D,H 
D,(SC,SN,C,H) 
C,D,H,(SC,SN) 

C,D,(H) 

D 

SC,(C),D,H 

SC,SN,C,D,H 

SC,SN,C,D,H 

SC,D 

SC,D 

D 

D 

D 

D,WP 

? 



Parameters in parentheses are needed with some drives and 
ignored by others (depending on the manufacturer and age). 
Any required parameters must be valid before a command is 
started. 

Although most of the commands are manufacturer-dependent, 
this usually does not raise problems. For normal operation of 
the drive, only the WDlOlO's and few of the really common 
commands are needed. Now let's have a look at the options. 

In the Restore and Seek commands, there is a four-bit rate field. 
This was originally intended to specify the step rate for head 
movements, with a zero value meaning 35 us per step and all 
other values representing counts of 0.5 ms per step (so that the 
range was from 0.5 to 7,5 ms). The hard disk controller had a 
memory for each drive's step rate, so the same value would be 
used for implied seeks later. But very soon, even with later ST- 
506 controller boards, this step-rate field became obsolete (due 
to handshake mechanisms between controller and drive). With 
today's IDE drives, the four lower bits of those commands are 
generally ignored. 
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The Read and Write commands originally had an option flag 
(M) for multi-sector (m/s) transfers. Today this flag is nonex- 
istent. For doing m/s transfers, the sector-count register is 
simply set to the desired number of sectors to be processed. 

But today's drives have another flag which originally wasn't 
there: the "Long" flag (L). When it is set, flie ECC (error- 
correction) data is transferred after the sector's data field. I 
assume this was meant for error correction when there are too 
many errors for the drive to correct automatically. However, 
there is a very odd characteristic: the ECC data is transferred 
in bytes through the data register. This is the only case where 
the data register doesn't transfer word data! By the way, the 
number of ECC bytes differs from drive to drive, but can be 
read out using the Identify Drive command. 

All generations of hard disk controllers and IDE drives support 
the last option flag for ReadAVrite commands, the Retry Flag 
(T). Normally, the drive retries to read/write a sector after non- 
fatal errors. When this option flag is set, automatic retries are 
disabled. The Scan ID command also supports this option. 

The Commands 

I will now explain the commands and their parameters in 
detail. To do this, besides drawing on my own experience in 
IDE interfecing, I collected detailed information and specifica- 
tions from three diHerent, independent sources. However, there 
still might be some slighfly different drives or controllers out 
there. Please inform me if you encounter problems or differ- 
ences with your disk. 

One general feature of both the WD 10 10 controller and mod- 
em IDE drives is implied seeks. That means you don't have to 
expHcifly move the read/write (r/w) heads to the desired cylin- 
der before starting to read from or write to the disk. When the 
command is issued and the actual cylinder number doesn't 
match that of the cyhnder registers, an imphed seek is per- 
formed, transparent to the user. This applies to every command 
where it may be needed (Read, Write, Verify, Format). 

Recalibrate (Ixh): 

This command moves the r/w heads of the selected drive from 
anywhere to cyhnder 0. The controller waits for the drive to 
complete the seek before the task file is updated and the busy 
flag is reset. Upon successful completion of the command, the 
error register and the cylinder registers are set to zero, while 
SC, SN, and SDH remain unchanged. 

Read Sectors (2xh): 

This is probably the mostly used cormnand. It will read from 
1 to 256 sectors of disk data as specified in the SC register (with 
an SC value of meanmg 256 sectors to be read). The starting 
sector is defined by SN, C, and H in the task file. 



Otherwise, the r/w heads are moved to the requested cylinder 
if they are not already there (implied seek). Then the data of 
the starting sector is read into the sector buffer, and the DRQ 
(data request) bit in the status register is then set. This informs 
the host that the sector data can be read from the sector buffer. 
When this is completed, DRQ is reset and the drive is ready 
again. 

For reading multiple sectors (SC>1), when the sector buffer is 
completely read and DRQ is reset, the busy flag is set again 
immediately, and the next sector's data is read into the sector 
buffer. When DRQ is set again, the next sector's data can be 
read from the buffer. This is repeated until the SC register 
value reaches zero (this register is decremented with every 
successfully read sector). 

In any case, after successful completion of this command, the 
SC register contains a zero value, and the other registers in the 
task file are updated to contain the cylinder, head, and sector 
number of the last-read sector. If an error occurs, the task file 
will contain the parameters of the sector at which the error was 
detected. 

For the Read Sectors command, two options are possible. The 
"M" option is valid only with the original WDIOIO controller 
(thus with old AT's). When M was not set (0), the SC content 
was ignored, and exactly one sector was read. When M was set 
(1), the SC value was taken as the count of sectors to read. 
Today things are different. With modem IDE drives, if the M 
bit is set, an error occurs. So this bit must always be cleared! 

The other option (' 'L") is valid only with modem IDE drives. 
"L" stands for long and means that the additional ECC data, 
which the drive automatically puts after each sector, is trans- 
ferred after the net data of each sector. When this option is set, 
the drive also does not check these ECC bytes, so it won't detect 
or correct errors. This provides a way to read a sector's (re- 
maining) data even if it is nomecoverably damaged. When 
using this option, remember that the ECC data is transferred 
as bytes through the word-wide data register! 

Write Sectors (3xh): 

The Write Sectors command is very similar to the Read Sectors 
command. Of course the data flow direction is different... This 
command will write up to 256 sectors of data to the disk. All 
parameters and options are similar to those of the Read Sectors 
command. After writing the command to the command regis- 
ter, the drive sets the DRQ flag, informing the host that the data 
can be written into the sector buffer. When all data has been 
transferred, DRQ is reset, and the drive starts writing the data 
buffer contents to the disk. The busy flag is set as long as the 
drive is physically writing to disk. The SC register is 
decremented, and, if not zero thereafter, DRQ is set again for 
the next sector. When using this command with the "L" 
option, the drive will use the ECC bytes delivered by the host 



When the task file contains invalid parameters, an error occurs. Continued after Centerfold, page 33. 
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Continued from page 26. 

and not generate any by itself. For the "M" option, the details 
described above apply. 

Scan ID / Verify Sectors (4xh): 

This is a very strange command. As far as I know, it is the only 
one that is totally incompatible between the old AT's hard disk 
controller and today's IDE drives. It would appear that this 
command was never used by common system implementation 
or application software... 

For the WD 10 10 controller, this is the Scan ID command. It 
takes no parameters at all (except for the drive and head which 
originally had to be contained in a register external to the 
WD 10 10). When the command is started, the controller searches 
for the next ID field and reads the contents into the task file. 
This way the actual drive, head, cylinder, and sector size could 
be examined. The sector number was also transferred into the 
task file, so the sector numbering order could be figured out by 
repeating this command fast enough. 

For the IDE drives, this is a completely diflerent command: 
Verify Sectors. It is similar to the Read Sectors command 
except that no data is transferred to the host, and the "L" 
option is not supported. Thus, it needs all parameters in the 
task file. Up to 256 sectors of data will be read into the sector 
buffer, and their ECC bytes will be verified. The DRQ flag will 
never be set. The completion status of the command can be read 
from the status register. 

It is interesting that both types of controller/drive support the 
retry option - so this is the only compatibility of this command. 

Format Track (5xh): 

Originally, this command was used to physically format an 
entire track of the hard disk, exactly as it's done when format- 
ting floppy disks. The Format Track command is started simi- 
larly to the Write Sectors command: first the task file must be 
set up, then the command written to the command register. 
After that, the drive responds by setting the DRQ flag. The host 
must then write data into the sector buffer until the DRQ flag 
is reset. After that, the command is executed. 

For the format command, the sector buffer must contain special 
data. As with the index field array when formatting a floppy 
disk, it must contain valid sector ID's for every physical sector 
of the track that will be formatted, beginning at the start of the 
buffer. Each sector ID in the buffer consists of two bytes. The 
unused remainder of the buffer is ignored by the format com- 
mand, but must also be written for the DRQ signal to disap- 
pear. 

The first byte of each sector ID is a flag byte. The WDIOIO 
knew only two different values for this descriptor: 
OOh = good sector. 



80h = bad sector. 

Today's IDE drives offer two more descriptor values: 

40h = assign sector to alternate location, 

20h = unassign alternate location for this sector. 

We'll look further at these values below. 

The second byte of each ID is the sector-number byte. It 

contains the number by which the related sector is referenced 

later during normal r/w operation. The ID fields in the sector 

buffer are assigned to the physical sectors (created through 

formatting) in the order they are stored in the buffer. So it is 

possible to define an interleave factor by appropriate physical 

sector numbering. Here is an example: 



Addr. 



00 = 


00 01 


00 11 


00 02 


00 12 


08 = 


00 03 


00 13 


00 04 


00 14 


10 = 


80 05 


00 15 


00 06 


00 16 


etc. 











Here we see the first 12 (of 32) ID words. The starting sector 
has number 1 (as usual). The interleave factor is two, since 
each sector appears two sectors after its logical predecessor. 
You can also see that sector number 5 (the 9th sector physi- 
cally) is marked bad. 

Due to surface errors on the hard disk, there are some positions 
where the media won't store magnetic information reliably 
enough (if at all). The defect list for a particular drive then 
shows the cylinder, head, and "BFI" (byte from index) value 
of the defect. People then had to calculate the bad-sector 
position and number from each of those BFI values. However, 
it is not commonly known that the relationship between the 
BFI value and the sector number depends not only on the sector 
size but also on the interleave factor and the starting sector 
number... 

Again, things changed as the years went by... I already men- 
tioned when introducing the features of modem IDE hard 
disks, that those drives don't have defect hsts any more, due to 
the usage of internal spare sectors. For compatibility reasons, 
these drives still accept the Format Track command. However, 
most drives only simulate its execution - internally they don't 
really format any track. Modem drives are "hard-sectored" by 
the manufacturer, with the sector size unchangeable by the 
user. But by virtually formatting a track, one can assign new 
sector numbers (for example, starting with instead of 1). 
However, the sector numbering order is often ignored. Because 
IDE drives commonly have built-in cache memories, the defi- 
nition of an interleave factor would make no sense. So, the 
drive always uses the fixed sector ordering which gives maxi- 
mum performance in combination with the cache. 

To make things still more complicated, the Format Track 
command of IDE drives allows for the assignment of data 
sectors to the spare sectors and for the release of those assign- 
ments (look at the descriptor bytes above). All IDE drives have 
some spare sectors to which the data of defective sectors is 
automatically mapped. Normally, there is one spare sector per 
track, resulting in about 2-3% spare capacify. This is more than 
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enough. When a sector appears too unreliable during normal 
operation, the drive simply marks that sector as bad internally 
and moves the data to the nearest free spare sector. As long as 
not all spare sectors are assigned, the user won't notice any- 
thing. However, these assignments can also be done explicitly 
by use of the Format Track command. But it is strongly recom- 
mended not to do that! First, one will normally get no defect 
list for an individual IDE drive containing the BFI positions. 
Second, even if a sector which was assigned to one of the spares 
is marked good again, the related spare sector can not be used 
again! So with every unassigrmient of a spare sector, you loose 
that irretrievably. 

So we come to this result: with standard (i.e., ST- 506) drives 
and external controller (i.e., WDIOIO) it makes sense to format 
the drive in order to freshen the surface magnetism, to get a 
defined state (sector numbering and order), and to mark defect 
sectors as bad (so that the operating system can behave accord- 
ingly). With IDE drives, it's best to leave them just as they are 
coming from the factory! 

Seek (7xh): 

This command is used to move the r/w heads to a particular 
cylinder explicitly. For normal operation of the drive, it is 
usually not necessary, since all r/w commands perform implied 
seeks. However, this command can easily be used for bench- 
marks to determine the drive's seek times. With the WD 1010 
controller, the four lower bits of the command byte contain the 
step rate (described above). IDE drives simply ignore these four 
bits. 

Execute Diagnostics (90h): 

This command is common to all IDE drives but not available 
with the WDlOlO controller. When issued, the drive performs 
an internal self-test. If the drive is a master drive, and a slave 
drive is coimected to it, the master also waits a limited time for 
the slave to complete its self-test. During all this time, it is busy 
(the according flag in the status register is set). After finishing 
the test procedure, its results are placed in the error register. In 
this special case, the content of the error register has to be 
considered as a single byte value, not as several bit flags. There 
are the following error codes: 
01 h no error detected, 
03 h sector buffer error. 

(These codes are supported by Conner drives. Maybe other 
manufacturers use more or different codes.) 

If the slave drive diagnostics failed, the MSB of the error 
register is set, leading to values of 8xh. However, even with 
single drive configurations this bit sometimes is accidently set. 
It may be ignored then. 

Set Drive Parameters (91h): 

An IDE-only command again. After power-up or reset, the 
drive can immediately be used in its default mode. However, 



the drive's logical parameters can be changed by. setting them 
with this command. This way, the drive can be set up to 
different modes in order to emulate the parameters of another 
common drive. The task file registers which are used with this 
command, and the way in which they are used, may differ. 
Some drives are really flexible and allow any parameters that 
result in no more than the drive's real capacity. Other drives 
(for example, my Conner CP-3044) support only two or three 
modes with fixed parameters. So for their selection, only part 
of the task file's registers are needed. Most, if not all, drives 
will accept this command with valid parameters in the SC, C, 
and H registers (even if not all the parameters are required), 
defining the number of sectors per track, cylinders, and heads. 

Because of the differences, it is advisable to first collect de- 
tailed information about the supported emulation modes of a 
particular drive, before defining its operadng parameters. 
Normally, it's best to operate a drive in its native mode (so the 
logical parameters equal the physical ones). However, there's 
another strange detail: there are drives which don't support the 
native mode! My Conner drive again serves as example: the 
drive has 1053x2x40 sectors (cylinders by heads by sectors) 
physically, but supports only a pseudo-native mode with 
526x4x40 sectors, and an emulation mode with 981x5x17 
sectors (which is for compatibility with older 40 MB drives). 
Additionally, depending on the internal software version, the 
drive defaults to the emulation mode or to the pseudo-native 
mode. 

As a result, it is recommended that the operating parameters 
always be defined after power-up or reset. And to define them, 
you must have detailed information about the drive you want 
to use. There is a "Product Manual" for every drive type, 
describing all those details. Unfortunately, these manuals are 
hard to get. Most dealers are not willing to give them to their 
customers (and some even don't have them in stock). The other 
way is to try out some parameters, starting with the information 
deUvered by the Identify Drive command. 



The break - a sample program 

I realize that I've already filled quite a few pages again. So I'll 
make a break here and continue the command descriptions in 
Part IV of the "Connecting IDE Drives" article series. Instead 
of continuing now, I'll show you a short program which reads 
the ID information of an IDE drive within a PC/AT, This 
sample program was written with Turbo Pascal 5.5 but may 
easily be used with any version above 4.0. 

You can try out this program on your AT (if you have one with 
an IDE drive) and play with it until receiving the next issue of 
TCJ with Part IV of the article. That part will finish the 
command descriptions and will also contain some more pro- 
gramming examples and shortform tables as a programmer's 
overview of the IDE interface definition. 
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Abbreviation list: 

BFI Byte From Index (position of surface defect) 

DRQ commonly used for Data Request (bit flag or signal line) 

IDE Integrated Drive Electronics (hard disk interface type) 

I/O Input/Output 

PC/AT . Personal Computer/ Advanced Technology ( a 

class of computers) 
r/w read/write 
ST-506 older hard disk interface standard, used between 

separate controllers and MFM/RLL drives 

program GetJDE ID; 

(* Q&D 930903 TiFmann Reh *) 

(* 930905 MSDOS *) 

(* Reads the ID Information of IDE drives and displays it. *) 

(* Should run with every IDE/AT harddisk drive. *) 

uses ct; 

const SIgnOn = "m^j'Read IDE ID Info V0.1 TR 930905'*m*j; 

(* I/O addresses and IDE commands: *) 



IDE Data 


= $1F0; 


IDE_Error 


= $1F1; 


IDE_SecCnt 


= $1F2; 


IDE_SecNum 


= $1F3; 


IDE CylLovi/ 


= $1F4; 


IDE CylHigh 


= $1F5; 


IDE SDH 


= $1F6; 


IDE CmdStat 


= $1F7; 


CMD_ldentify 


= $EC; 


(* Data types and variables 


*) 


type WorkStr 


= string[80]; 


BufType 


= array[0..255] of w/ord; 


IDRecord 


= record 


Config 


: integer; 


NumCyls 


: integer; 


NumCyls2 


: integer; 


NumHeads 


: integer; 


BytesPerTrk 


: integer; 


BytesPerSec 


: integer; 


SecsPerTrack 


: integer; 


d1,d2,d3 


: integer; 


SerNo 


: array [0.. 19] of char; 


CtrlType 


: integer; 


BfrSize 


: integer; 


ECCBytes 


: integer; 


CtrlRev 


: array [0.. 7] of char; 


CtrtModI 


: array [0..39] of char; 


SecsPerInt 


: integer; 


DblWordFlag 


: integer; 


WrProtect 


: integer; 


end; 




var SecBuf 


: BufType; 


IDR 


: IDRecord absolute SecBuf; 


Sees 


: real; 


ij 


: integer; 


(* Convert bylelword values to hexadecimal strings: *) 


function HexByte(x:byte):WorkStr; 


const Nib: array[0..15] 


of char = '01 23456789ABCDEF'; 


begin 




HexByte:=Nib[x shr 4]+Nib[x and 1 5]; 


end; 




function HexWord(x:word) 


:WorkStr; 


begin 




HexWord:=HexByte(hi(x))+HexByte(lo(x)); 


end; 




(* Swaps the bytes of each 


"word" in string for correct reading. * 


function SwapStr(s:WorkStr):WorkStr; 


var si : WorkStr; 




i : byte; 




begin 




s1[0]:=s[01; 





for i:=0 to pred(length(s)) do s1[i+1]:=s[(i xor 1)+1]; 

SwapStr:='>'+s1 +'<'; 

end; 

(* Show error codes: status register and error register. *) 
procedure Error(s:WorkStr); 
begin 

writeinC ',s,'; Status: ',HexByte(port[IDE_CmdStat]), 
' ',HexByte(port[IDE_Error])); 

halt; end; 

(* Wait until drive is ready. *) 
procedure WaitReady; 
const Timeout = 5000; 
var i : word; 

begin 

i:=0; 

while (port[IDE_CmdStat]>128) and (i<TimeOut) do begin 
delay(l); 
inc(i); 
end; 

if i=TimeOut then Error('WaitReady TimeOut'); 

end; 

(• Wait for data request (DRQ). *) 
procedure WaitDRQ; 
const TimeOut = 5000; 
var i : word; 
begin 

i:=0; 

while (port[IDE_CmdStat] and 8=0) and (i<TlmeOut) do begin 
delay(l); 
inc(i); 
end; 

if i=TimeOut then Error('WaitDRQ TimeOut'); 

end; 

(* Send command to drive. *) 
procedure IDEcommand(Cmd:byte); 
begin 

WaitReady; 

port[IDE_CmdStat]:=Cmd; 

WaitReady; 

end; 

(* Read sector buffer of drive. *) 
function ReadSecBuf(var Buf:BufType):boolean; 
var i : word; 

begin 

WaitDRQ; 

for i:=0 to 255 do BufIi]:=portw[IDE_Data]; 

ReadSecBuf:=port[IDE_CmdStat] and $89=0; 

end; 

(* MAIN; read drive's ID information. *) 
begin 

writeln(SignOn); 
IDEcommand(CMD_ldentify); 
if not ReadSecBuf(SecBuf) then Error('Read Identify'); 
with IDR do begin 

writeln('ID constant 

writeln('fixed cylinders 

viffiteln('removable cylinders 

writeln('number of heads 

v*n-!teln('phys. bytes per track 



',Config,'(',HexWord(Config),')'); 

', NumCyls); 

',NumCyls2); 

'.NumHeads); 

: '.BytesPerTrk); 



writeln('phys. bytes per sector : '.BytesPerSec); 



wrlteln('sectors per track 
writeln('serial number 
writeln('controller revision 
wrlteln('buffer size (sectors) 
writeln('number of ECC bytes 



.SecsPerTrack); 
'.SvrapStr(SerNo)); 
',SwapStr(CtrlRev)); 
', BfrSize); 

.ECCBytes); 



writeln('controller model : '.SwapStr(CtrlModl)); 
Sees := int(NumCyls+NumCyls2) * NumHeads * 
SecsPerTrack; 

wrItelnCtotal sectors : '.Secs:1:0); 

writeln('capacity (MBytes) : ',Secs/2048:1 :1); 
end; 
end. 
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Copyright Herbert R Johnson, Oct 1993. 

This month, I'll cover the process of 
adding a new BIOS and a new disk 
controller to a S-100 system. But first; 

Mail and Messages 

Before I answer the mail, I have a re- 
quest to my readers. I need Internet 
access! There is just too much CP/M 
activity going on in the Internet that I 
have no access to. Can anyone offer me 
legitimate access within the Trenton/ 
Princeton NJ area? 

Several people have written to me in the 
hopes of finding a "good home" for 
their S-100 systems. Understandably 
reluctant to discard them, and unable to 
sell them in the " IBM' ' computer world, 
they believe there is still good Ufe, or at 
least good tinkering opportunities, with 
their systems; and they hope I can give 
them a few bucks too. My general re- 
sponse is to request a list of boards, 
documentation and software in the hopes 
I can match up one person's needs with 
another's. Occasionally I'll buy a few 
systems that strike me as interesting, or 
in response to a buyer's requests. Gener- 
ally I sell replacement cards to people 
who need a specific board, or in re- 
sponse to someone's need for some ad- 
ditional I/O or memory. With prices low 
but shipping costs high, especially for 
heavy cases and power suppUes, this strat- 
egy makes a lot of sense to me. 

Of course, if you need a card, system, or 
docs let me know ! For instance, Michael 



Griffln of Tillsonburg, Ontario Canada 
writes: 

"Some months ago, I was given an old 
Compupro 8/16 in a pair of 19" rack 
mount cases. Unfortunately, all of the 
documentation and floppy disks had been 
thrown out some time before [a common 
situation - He A]. The computer, how- 
ever, is believed to be in excellent shape. 
Although it was originally purchased 
around 1985-86, h saw very little use. 

' 'I would like to obtain information about 
this system, the cards listed below, and 
about S-100 Bus computers in general. I 
don't know enough about this system to 
even successfully fire it up. It contains 
the following boards; 

Compupro: CPU 8085/8088 [a dual pro- 
cessor card], M-Drive-H [a RAM disk], 
Ram 23 [static memory card]. System 
Support 1 [a general purpose I/O card, 
including the console serial port], 
Interfacer 3 [a hard disk controller], Disk 
lA [8" and 5" floppy disk controller]. 
Also, Illuminated Technologies, this may 
be a special video card; and SSM 104 
[another I/O card] and a number of cus- 
tom boards which I do not intend to 
worry about for now. 

"The disk drive unit contains an 8" 
floppy drive and a 40 Meg Quantum 
Q540 hard drive [5-inch] . The operating 
system used was CP/M 2.2, I think [it 
could also have been CP/M-86, it can 
run either]." 

Michael, I have a system very similar to 
this and I have some docs I can share 
with you: I'll contact you shortly in de- 
tail. I can provide a CP/M 86 boot disk, 
I believe. Anybody know about the "Il- 



luminated" card? Also, Michael doesn't 
mention the hard disk controller in his 
list. Compupro used a Disk 2 or Disk 3, 
which may include a second card for 
DMA (direct memory access, a bus con- 
troller to speed up data transfers). Any 
5.25" disk controller will have a number 
of 20-pin connectors and one 40 pin 
connector. 

Thanks to Kenneth Kutaiek of Ever- 
green, CO; Larry Cameron of Austin, 
TX; for sending their lists of stuff to me. 
I'll see what I can do to help. 

John Butler of London, England (!) 
writes to ask if I know about changing 
the Osborne Executive built-in disk 
formats. He wants to read Kaypro for- 
matted diskettes, but he says the 
Executive's BIOS has "private codes" 
in the Disk Parameter Block beyond the 
typical ones, and he can't find the right 
combination! He also wants "a driver 
for hard disks: I know Trantor, etc., did 
them, but they never published. To im- 
port, paying customs duty and insurance 
is hell - much simpler to buy the code if 
available. A CD-ROM would be even 
better!" 

Sorry I can't help you, John. It is not an 
S-100 system, and I know it only by 
sight. You seem to know the basics of 
BIOS and disks; you might try to get the 
BIOS source code and attempt to inter- 
pret the private codes. You might try to 
get on the FidoNet's CPMTECH echo 
and make your request: there is likely a 
BBS supporting FidoNet in your general 
area. 

Gregory Nakshim suggested to me that 
Stan Veit's book. The History of Per- 
sonal Computers, is a helpM reference 
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on S-100 computers and related systems 
of the era. It sells for $19.95 softcover, 
$24.95 hard. See References for the pub- 
lisher. 

New capability: papertape! 

In the old days.... when personal com- 
puters first came out, there were NO 
peripherals available, other than what- 
ever could be scrounged from mid-1970's 
industrial technology. At that time, small 
data storage was on paper tape (figure 
0), a sturdy medium consisting of 1-inch 
wide paper rolls punched with a series of 
8 data holes to represent a byte and one 
"feed hold" of smaller size. The most 
common type of readers and punches 
were on Teletype terminals, but main- 
frame computers and industrial control- 
lers of mills and drills also had these 
devices. 

I attended my first New Jersey hamfest 
(radio amateiu" flea market) in mid-Oc- 
tober, and I was finally able to acquire a 
papertape reader/pimch from a Heathkit 
H-lI(aDigital Equipment PDP-11 com- 
puter) system. After I test and interface 
(parallel) it, I should be able to provide 
papertape to all those classic system 



owners who have been waiting for 4K 
BASIC for the last 15 years! By the way, 
does anyone out there have a box of 
papertape for me? 

Tutorial Topic: methods for building a 
BIOS for a disk controller. 

Last issue, I described the workings of a 
disk drive and disk controller, and I 
provided skeletal code for accessing a 
disk. Briefly, a diskette has many tracks, 
each divided into sectors. The BIOS 
(Basic Input/Output System) code in CP/ 
M provides routines for selecting a drive, 
track and sector; and for reading and 
writing to a sector. It also has a "trans- 
lation table" to convert sector numbers 
from "physical" (as written into the 
sector itself) to "logical" in order to 
improve access times by spreading out 
the physical distance between logically 
sequential sectors. (Bill Kibler reviewed 
very briefly the operation of CP/M and 
the building ofnew systems in his "Com- 
puter Comer" article in issue 62.) 

I had hoped this month I could get into 
the details of the SD Systems disk con- 
troller card and how to use a combina- 
tion of CP/M and shareware utilities to 



MOVCPM: This utibty rewrites code 
addresses in CP/M, so that the resulting 
code! can run in a new memory location. 
The commands 

MOVCPM * 32 
SAVE 44 CPM32.COM 

will create in low memory a 32K 
version of CP/M, followed by a save of 
the rnemory image to a file called 
CPM32.COM, Use DDT or DU to 
examine this file. The number "44" 
is a decimal count of 128 byte segments 
(sectors on an 8" SSSD disk). This 
number may vary from system to 
system. Too small a number will not 
save all of CP/M 

DUMP: a CP/M utility to display the 
contents of a file in both hex and ASCII. 

LOAD: This utility converts a .HEX 
filetoa .COM file, or executes a COM 



CP/M UTILITIES 

file. Caution: it will load the file into the 
memory referred to in the HEX address 
records, which may wipe out whatever is 
there. Use DDT and an offset to load 
into a different memory area. For 
example, a .HEX file with the record: 

nn 1 (WOnimnnnnnn 

will load into location lOOOH with 
LOAD, but with the DDT command 

rFlOO 

it will load into OlOOH instead (FlOO + 
1000 = 10 100, interpreted as 0100). 

DDT: CP/M debugger. Commands of 
note arc: 

ifilen.com indicate file "filen.com" 
for loading or writing 



create a new system from an old disk 
system. However, after scanning previ- 
ous issues of TCJ, and after reviewing 
my hours of work on my IMSAI-based 
S-IOO development system, I realized I 
need to cover the background of CP/M 
system development and of the bootup 
process, as well as describe some "se- 
crets" of CP/M development and some 
key shareware utilities. 

So, I will try to work "backward", from 
the issues of tracks and sectors on the 
diskettes; to the layout of CP/M on disk 
and in memory; to how CP/M gets loaded 
and started. I'll also cover some of the 
features of CP/M programs like ASM, 
DDT, SYSGEN and LOAD; as well as 
DU or DUU, the famous disk utility pro- 
gram that you must have to do any use- 
fiil work on disk development! (Check 
any CP/M system or utilities supplier for 
a copy.) Throughout this article, I will 
sprinkle some "hints" about 
manufacturer's variations in the features 
and capabilities I'll describe. You may 
want to ignore these hints if you are new 
to this material, and reread them later. 
You can read the Sidebars for details of 



rlOOO read the indicated file into 
memory, offset its loading address by 
lOOOH (.HEX files are read into the 
addresses they contain; .COM and 
others into address OIOOH plus the 
offset. 

'^C exit DDT, return to CP/M 
prompt. 

How does DDT work? Among other 
things, it uses a software reset 
instruction. RST 7 (07H), to return 
control to the debugger at convenient 
points in your code. We will use this 
feature to test the boot code. 

ASM: CP/M Assembler 

ASM file.abc assemble file 

A:FILE.ASM, create hex file 

B:FILE.HEX and listing file 
C;FILE.PRN. 
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the basic features of CP/M and of the 
utilities. 

I should say that a series like this could 
go on forever with excruciating details 
and asides. The more readers who con- 
tact me with their reactions the better, 
even if to only say ' 'great! " or ' 'yuck! ' ' . 
I will confide to you (don't tell anyone!) 
that it can be discouraging to write about 
an 18-year-old operating system without 
receiving some feedback! 

Disk hardware: This article series will 
presume a typical 64K (RAM) S-100 
system with 8-inch, single-sided, single- 
density disk drives and controller. The 
8" SSSD diskette has 26 sectors per track, 
77 tracks, and each sector holds 128 
bytes for a total capacity of about 256K 
bytes. Other diskette densities and sizes 
will perform similarly but have addi- 
tional complications, such as density 
detection and a variety of system track 
layouts. 

My current controller is a Morrow DJ2D, 
with its ovra serial port and ROM; the 
"new" controller I'm adding is a SD 
Systems Versafloppy II controller, with 
neither ROM nor serial port. I have the 
sources for the SD Systems BIOS, but 
th^ required much rewriting and lifting 
of code from other controllers, most 



CGP: Console Command Processor. 
Similar to the C0MMAND.COM of 
MS-DOS and the "shell" of UNIX, 
this code receives commands from 
the console terminal and either calls 
the internal CP/M commands (DIR, 
DEL, REN) or calls external pro- 
grams of the form nimnnnnn.COM, 
where "nnnnnnnn" is a filename of 
up to 8 characters. This code is hard- 
ware independent, and can be relo- 
cated with MOVCPM. 

BDOS: Basic Disk Operating Sys- 
tem. This controls the opening and 
closing of files, access to devices, 
and converts operating system re- 



notably the original Tarbell single den- 
sity 8" disk controller. 

Recommended reading and software: 

The Digital Research CP/M manuals 
describe the operation of all their utili- 
ties and the process of BIOS develop- 
ment. If you do not have these, search 
your local libraries for old CP/M books 
or books on particular CP/M machines. 
Or, contact me: if demand warrants it, I 
may write a more complete description; 
or find a cache of CP/M documents! 

In principle, you should only use one 
copy of CP/M at a time! And, you should 
have a serialized licensed diskette fi^om 
Digital Research. If you need one, I have 
some for sale; other vendors in this 
magazine will also sell you CP/M. (Hint: 
some of this series may also apply to the 
Z-System, but I don't have enough expe- 
rience to verify this personally.) 

Boot-up operations 

For most systems, there is a small bit of 
ROM (read-only memory) buried on 
some card that is ' 'jumped' ' to at power- 
up or reset (see figure 1). For our pur- 
poses, this code eventually loads in some 
"boot" code from a floppy diskette, 
which will in turn read in the "system' ' 
code on the disk containing CP/M and 
the BIOS that is particular to your sys- 
tem. Because the first track of the disk 
(track 0) is the easiest to find, the boot 



code is contained on track 0, sector 1. 
The system code will follow, on the rest 
of the sectors of the first track and for all 
the sectors of the second track. Figure 1 
shows a layout of these two tracks for an 
8" SSSD diskette. (Knt: different manu- 
facturers may use slightly different 
schemes! Use DU (See Sidebar) to get 
familiar with how YOUR boot tracks 
are laid out!) The boot code in the first 
sector is read by the ROM (1) into a 
convenient memory area (usually address 
0) (2) and executed. The boot code in 
turn reads the rest of the sectors (3) into 
the high end of memory (4) and then 
jumps to the CP/M starting address (of 
the code just read in) to initialize and 
run CP/M. (Hint: some systems follow 
this sequence with the load of a more 
complicated BIOS from a file.) 

This division of tasks is intended to 
minimize the ROM requirements of the 
disk controller, and to make it easy to 
modify the location of the operating sys- 
tem. The boot code on disk is changed to 
create a new loading address for CP/M, 
and the operating system and BIOS are 
changed to support operation in the new 
area of memory. In the days when 
memory was not cheap and ROM code 
features were far from standard, this flex- 
ibiUfy was essential. 

To modify CP/M, the program 
MOVCPM created a new "image" of 
the operating system which ran at the 



CP/M INTERNALS 

quests to calls to the BIOS. This code is 
hardware independent, and can be relo- 
cated with MOVCPM. 

BIOS: Basic Input Output System. A 
coUecfion of hardware-dependent code 
for disk access by track and sector, and 
device access. Each manufacturer or 
developer must adapt this code to their 
parficular hardware. This code may be 
relocated by a manufacturer-modified 
version of MOVCPM: check your ver- 
sion. 

jump table: At the start of BIOS is a 
series of IMP instructions to a defined 
set of capabilities in a defined order, 



using the 8080 registers to return ap- 
propriate values. 

"Synchronization error": When you 
try to use a utility from one CP/M 
with another copy of CP/M, particu- 
larly the urilify MOVCPM, you may 
see this message. Each CP/M BDOS 
(CCF.0 has a serial number embed- 
ded within it that is matched by some 
of the utilities. A feilure to match 
causes the utility to stop and produce 
this message. Either use a consistent 
copy of CP/M or modify the serial 
number (the latter I leave to the reader 
for now!). 
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desired memory size. To modify the 
BIOS, the user re-assembled it at the 
desired memory size as well. (Hint; some 
MOVCPM's will also re-address the 
BIOS code as well as CP/M, so 
reassembly is umiecessary.) Tradition- 
ally, DDT was used to ' 'glue' ' these two 
together in memory, and SYSGEN was 
used to copy them to the boot tracks. (I'll 
use DU instead!) Figure 2 shows typical 
addresses for CP/M's CCP, BDOS, and 
the BIOS for a 56K RAM machine. (Hint: 
CP/M systems with double density or 
larger sector sizes have more room for 
both a bigger boot program and a bigger 
BIOS, so these addresses can vary! Read 
your docs and prowl through your cur- 
rent system with DU.) See the Sidebar 
for more details on MOVCPM, DDT, 
DU, and other terms. 

Adding a new disk controller 

CP/M was a success because of its unique 
abihty (at the time) to be adapted to any 
Intel 8080-based system with appropri- 
ate hardware: RAM memory available 
from address on up, a disk controller, 
and a serial port. The operating system 
itself (CCP and BDOS) were "movable' ' 
without re-assembly by the use of 
MOVCPM, a program that would modify 
the code addresses within CP/M, to al- 
low the code to run at the top of what- 
ever memory was available. To add hard- 
ware, a manufacturer (or even user!) need 
only write a BIOS of a standard form, 
including at the start of the code a jump 
table: a series of JMP instructions to 
routines that return after doing standard 
things, including the disk operations I 
described in my previous article; as well 
as console (terminal) and printer opera- 
tions. 

For this series, I'm going to avoid the 
hard problem of trying to bring up a 
"diskless" system with a new control- 
ler. Instead, I'll show how to add a new 
controller to a system which has an- 
other disk controller. (Hint: if you have 
a ROM-based system that allows you to 
modify memory, you can use that to load 
and test code instead, from another sys- 
tem which acts as a terminal.) How can 



this be done without interfering with the 
old controller and "old" CP/M? 

1) The two controllers must not overlap 
in memory or I/O space. Shared addresses 
will create obvious conflicts. However, 
they can share resources, say a serial 
port or ROM code as only one operating 
system will be mnning at a time. 

2) The original CP/M must run in higher 
memory, while the "test" CP/M will be 
loaded and run in lower memory; and 
these must also not overlap. See figure 2 
for a reasonable memory map of such a 
configuration. Note that DDT resides 
just below BDOS when DDT is loaded; 
its size must also be taken into account. 
Building a 32K "test" system will give 
plenty of room for both CP/M's, although 
it will be too cramped for any serious 
work later. 

3) The test controller's boot sector code 
must not load below location 100 or 
above the test CP/M's memory areas. 
Location lOOH is a reasonable place to 
load and execute the test boot code. For 
convenience, let's call the source file for 
the boot sector code BOOTDISK.ASM 
(this name is not in any manuals!). 

4) You have (at least) one drive for the 
original controller, and one drive for the 
test controller. You can do this on your 
current two-drive system by disconnect- 
ing the second drive from the disk con- 
troller cable, changing the drive's ad- 
dress (usually from "drive 1" to "drive 
0") and attaching that drive to the sec- 
ond controller. See figure 3 for the lay- 
out. (Hint: this scheme allows you the 
option of flopping the second drive be- 
tween either of the two systems, as re- 
storing two drives to your original con- 
troller will speed up development.) 

5) You will need a bit of code to load in 
the boot code from the first sector on the 
bootable disk. This code will eventually 
reside in ROM, so let's call it 
BOOTROM.ASM. (This name is an 
arbitrary name too!) It will be similar to 
the disk's boot code, but it only need 
read in one sector and to jump to it. Be 
careful it does not overlap the disk's 



boot code, or it will try to load the disk's 
code over itself! 

Testing for loading and "good" ad- 
dresses 

With this scheme, here's how you will 
test your new controller's BIOS and CP/ 
M. First, to verify that your boot code 
works and that the BIOS and CP/M are 
properly relocated: 

1) Boot up your current CP/M on your 
current controller. Edit, assemble and 
load your new BIOS and disk boot code 
BOOTDISK.ASM . Make sure 
BOOTDISK will run at OlOOH, and 
change the code to jump to DDT after 
loading via the RST 7 instruction (see 
Sidebar). Move the assembled code to 
the system tracks of your test boot disk 
(with DU, details on this move later!). 
Place your test disk on the test controller's 
drive. 

2) Use DDT to load the 
BOOTROM.HEX file (the assembled 
boot code) and to execute it. The ' 'ROM" 
code will run the other controller and 
drive, load the boot sector and execute it, 
which will in turn load the new CP/M 
and its BIOS into memory below the 
"current" CP/M. Instead of executing 
the code, it will return control to DDT. 

3) Examine memory with DDT and 
verify that all the code was loaded at the 
appropriate addresses. (Hint: for front 
panel machines, or machines with ROM 
monitors, you might use these capabili- 
ties to verify proper and complete load- 
ing.) Note any problems. Reboot the old 
CP/M system and make appropriate 
changes to the code. 

4) Repeat steps 1-3 until satisfied with 
the operation of BOOTDISK and the 
layout of CP/M and BIOS. Then, modify 
BOOTDISK.ASM to give control to the 
new CP/M after loading it. Assemble 
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and load the new version, and place it on 
the test boot disk. 

To verify your code is ' 'properly loaded' ' , 
consider the following: 

1) A hex dump of the beginning of the 
BIOS code looks something Uke this: 

C3 21 73 C3 44 73 C3 82 73 C3 01 74 



the "C3" is the jump (JMP) instruction; 
and the 2 following bytes are the jump 
address, the low byte and the high byte. 
For example, the first three bytes shown 
above are the instruction "JMP 7321". 
The high byte should be consistent, start- 
ing low and changing by one after a few 
"jumps". If you use DDT to look at 
these in memory, the code should be 
located in the same area as the first few 
jumps. That is, the first few BIOS rou- 



Shareware utilities 

DU or DUU: Ward Christian's Disk 
Utility. This program allows you to 
read iadivldual or sequential sec- 
tors on a disk, gather them into a 
memory buffer, change disks, and to 
write the buffer out to ancrther disk! 
This utility will save you the trouble 
of writing a SYSGEN program, plus 
enable you to move assembled code 
from disk to disk. The DU commands 
needed are illustrated as follows: 

la;. load diskette on drive A as 
the current disk 

t2;s3;r;d Track 2, Sector 3, read it, 
dump to saeen 

r;«;+;/lO read it, save sector 

to buffer (as newest) and accumu- 
late> go to the next sector on disk, 
and repeat this line of commands 10 
times 

»;w,+JlO recall the first (oldest) 
seaor in the buffer, write it, go to the 
next sector on disk, and repeat this 
line of commands 10 times 

? display all the commands 



tines usually reside at the beginning of 
the BIOS area; in this case at 7300 and 
above. If you see an inconsistency, you 
have either loaded the BIOS into the 
wrong area, or you assembled it for the 
wrong area. 

2) A similar rule of thumb applies to CP/ 
M. If you use DU or DDT to look at the 
first bytes of CP/M on the boot tracks, 
you'll see something like the following: 



03 nn nn C3 nn nn . 
(more code) 

(zeros) 



•CxxCxx * 

* COPYRIGH* 
*t(c) 1979 DIG* 
•ITAL RESEARCH * 



This marks the beginning of CP/M CCP. 
Look at the jump addresses in this area, 
and see if they are consistent with where 
the CCP will eventually be loaded. BE- 
WARE that DDT will overwrite the CCP 
area, so you can't use DDT to look at the 
CCP in memory! However, you can use 
DDT to look at BDOS and BIOS. 

Once you are confident that loading and 
addressing is correct, use a similar 
scheme to the above to test and execute 
the new BIOS and CP/M. Run simple 
CP/M commands like DIR, then STAT. 
PIP a large collection of files, using the 
[v] option to verify them. Then, ASM a 
few files. I like to use the shareware 
utihty CRCK (checksum) to read all the 



files and write a file of checksums as a 
test of CP/M operation. 

Summary 

We have reviewed the features of CP/M 
relevant to BIOS development, ' 'walked 
through" a development cycle and de- 
scribed the layout of memory. Next time, 
I'll show more specifics of the two disk 
controllers, particularly the SD Systems 
Versafloppy II card, and its BIOS. I have 
several of these cards available if anyone 
is interested in following along on their 
S-100 system! 
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Special Feature 

Intermediate Users 

Part 1 : What is Available 



SMALL -C ? 

Introduction by Bill Kibler 



Some issues back, I broached the subject of a magazine en- 
dorsed programming language. The idea was to use some 
standardized programming environment and language for all 
articles. The magazine would make it possible that this choice 
would be available for all platforms we support. Thus, it would 
provide all our readers with a learning and working set of 
language tools at an affordable price. Currently, there is no 
known standardized language available across all platforms. 

Forth is probably the closes language that actually attempts to 
be similar across all platforms. Even still, there is not a single 
version of Forth that works completely the same on all plat- 
forms. Many of the older classic systems came with BASIC in 
ROM or on disk. The BASIC'S were not anything approaching 
implementations of a standard. You can expect each BASIC 
platform to require major changes in coding to move from one 
platform to another. 

For teaching, PASCAL is considered superior. The structured 
design of PASCAL was intended to teach programming lan- 
guage concepts and practice. Several implementations have 
proven that the language can also be used quite successMly 
outside of the educational environment. The company Borland 
rode to success on their Turbo Pascal implementation for CP/ 
M and later MS/DOS. Turbo Pascal's success in part is also the 
integration of programing and editing tools in one package. 

Unix users have come to enjoy using C and find many featiu-es 
they consider superior to any other language. Of interest to us, 
is the migration of C, back to smaller platforms. Ron Cain 
implemented a version for small platforms with the intention 
of teaching users about C. That version was called "Small-C" 
and was explained in a book about the language. Since this 
version was very small and self compiling, many options and 
features were not provided. The basic set of functions however 
was easily ported to other platforms. 

Since the direction at The Computer Journal is to teach our 
readers how to perform simple and basic tasks using tools 
suited to their platform of choice, finding a language has 
become an important decision. 

One language that has been broached is of course Forth. I am 
a long time user of Forth and have seen many items available 
which might make it our best choice. There are BASIC and 



PASCAL interpreters that run under F83 Forth. I am aware of 
projects to create C interpreters using Forth platforms. Forth is 
also available in several versions of C source for use on UNIX 
and LARGER platforms. A new version of Forth for embedded 
controllers, EFORTH, is just about ported to all platforms. This 
might give our readers an across the board single implemen- 
tation. 

Since all users are not especially fond of Forth, an alternative 
language and options should be considered before making any 
long term choices. I proposed that Small-C might be that 
alternative. Current Small-C implantations are fairly exten- 
sive, but have the same problem as Forth, major variations 
between platforms. Since my experience with these variations 
of C is Umited, I have turned to our readers and writers for 
input. Not all our readers feel strongly that even C would be a 
good choice. Some experiences have shown the problems that 
need to be addressed. 

What follows is most of what has been sent to me to date. I have 
added index summaries of the C Users Group listings of the 
disks on which Small-C versions are to be found. I did not list 
any of the utility programs that have versions for the Small-C 
language. I found at least 10 to 1 5 disks that have separate tools 
for Small-C users. This last fact should be considered as a plus 
for using Small-C. Accessory tools are very important to any 
language and having tools already done must not be over 
looked. 

Lets hear then from our writers and readers in this first install- 
ment of "to C or not to C? " (Sorry for the pun . .but have fiin. . . . 
BiU Kibler.) 

Dear Bill: 

I've been thinking about this contioversy that seems to have 
come up regarding the code for the serial gizmos Walt wants 
to design. While the Forth that Brad Rodriguez and Frank 
Sergeant write is pretty readable to me at least, in the past I 
have had terrible problems with reading Forth. 

But, as you mention, assembly takes up too much space, and 
Pascal would be too cumbersome for the project to be written 
in. I don't like pseudocode, because it isn't the real code, and 
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when you actually try to write something, little gotchas always 
come up. 

I have two ideas. First, we write a Pascal-to-Forth or Small-C- 
to-Forth translator, in Forth, to allow conventional block- 
structuring, top-down, algebraic coding. Really, it isn't Pascal 
nor C, though, but a preprocessor/reformatter that does not 
change Forth at all, but reorders and reformats the statements 
so that they look conventional. 

The bad part about that idea (which is not a new idea, by the 
way), is that the Forth folks won't like it ("it just isn't Forth' '), 
nor will the Pascaloid folks ("it just isn't Pascal' '). It could be 
argued that it really is Forth, however, if you remember Prolog, 
there were several different syntaxes for it ("Edinborough", " 
Clocksin-Mellish") which were quite different-looking. Who 
says Forth can have only one appearance? The translator could 
be written in Forth or in M4, awk, C, Pascal, BASIC, whatever. 

OK, then, the other suggestion is to find a way to make the 
assembler take less space. One way is by putting multiple 
statements per line: 

inc dptr : movx a,@dptr : ret 
The other way is by using macros. As a long-time assembler 
programmer, you know problems with macros: "What does it 
do, again?" "What side effects does it have?" And when you 
forget what the macro does, the macro code itself is unreadable. 
And, of course, every assembler has tremendously different 
macro syntax, so macros aren't portable. 

We can solve all of the latter problems by writing our own 
maao preprocessor in BASIC. Why BASIC? Because BASIC, 
is the language most of us have, and it's the most portable 
language we have accessible. You might even be able to run the 
preprocessor on an 8052 chip with built-in BASIC. 

But why stop there? We can write our own assembler, too! OK, 
now I imagine I'm getting carried away. 

Have fiin! 
Rick Rodman 

From Tilmann Reh over numerous E-Mail discussions con- 
cerning the choosing of a language. 

<From June> 

Concerning programming languages, I do not like Forth as a 
medium to describe some software technique, even if it is very 
portable. Most people will be unable to extract algorithms out 
of a Forth listing! So we always should use 'algorithmical' 
languages to explain our ideas. The ideal language for this 
purpose is Pascal (or Modula), as explained earlier. Every 
Forth programmer will be able to port an algorithm from a 
Pascal source to his Forth assembler. This does not apply vice 
versa. So, the only really portable software language is the 
algorithm itself, or anything similar (like Pascal). 

BTW(By The Way), your argument that Pascal is too strict for 



hardware level programming does not apply. Common Pascal 
compilers all offer some method to access the hardware di- 
rectly. At least you might define subroutines located anywhere 
which do some special hardware-related fimctions, and are 
called by really readable symbolic names. From my experience 
of programming (high-level and assembler), there is absolutely 
no argument against structured high-level languages even when 
programming at the hardware level, except for some run-time 
limitations in some cases. Instead, software development times 
are much shorter when using (for example) Pascal. 

<From Late June> 

I still am sure that Pascal (or Modula, Ada) are the languages 
of first choice if you want to EDUCATE. This because these 
languages express the used algorithms very directly and clearly. 
If we really want to educate our readers, we must show them 
HOW to solve a problem, and not print a listing of a special 
implementation which is unportable to other programming 
languages! So may I repeat that the structured modular lan- 
guages (mentioned above) serve this purpose much better than 
any other, even C. Every reader who does programming him- 
self will then be able to adopt the used method to the language 
of his choice, which is (nearly) impossible with every other 
language (I think). 

I don't know a Pascal for OS-9 or Flex, probably because I 
never used those systems. But I am sure there must be some- 
thing... And if not, see the last sentence of the previous para- 
graph. 

Last but not least, be aware that there are no efficient C 
compilers for microcomputers, especially for the 8-bit world. 
The code size and efficiency is so bad that even in this concern 
Turbo-Pascal is better. (So you won't help people with <64k 
systems by using C.) 

<From July> 

I must agree that BASIC is best available for any small com- 
puter system. However, BASIC is by far not the right language 
for teaching anything. The only thing you can teach with 
BASIC is a bad programming style... May I repeat my "Gen- 
eral Portability Rule": You can very well port a Pascal pro- 
gram to BASIC, but it will often be veiy hard work to port a 
BASIC program to Pascal (when saying "Pascal", I also think 
of other structured languages like Modula or Ada). This is 
because BASIC is not strict enough, and uses jump instructions 
(GOTO) very often. The only way to educate though using 
BASIC, is writing BASIC programs as if it were Pascal! If you 
have someone who edits all incoming BASIC programs ac- 
cording to this rule, I might as well agree to use this language 
more often. 

<From August> 

I agree that BASIC can also be programmed well-structured. 
But the fact is that "^most* BASIC programmers *don't*. I 
think it's not possible to change this, so I would discard BASIC 
for our purposes. 
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I don't think that Forth is better than Pascal. Nor for real work, 
neither for education. May I repeat again (the third time?) that 
a Pascal source can be read by everyone and easily translated 
to any language of his choice, but this is absolutely impossible 
with a Forth program (only if the reader is well used to Forth). 
The optimum would be to teach only algorithms, but if we print 
programming examples, we should use a language which is 
nearest to the algorithm, so *eveiy* reader is able to under- 
stand and translate it, if necessary. I think the only language 
which reaches this goal is Pascal (or Modula or Ada, which 
however are less usual; or structured BASIC, which is possible, 
but in fact even less usual). 

Sincerely, Tilmaim Reh. 

Dear Mr. Kibler; 

Inyoiu- 'Computer Comer' in the #61 issue ofTCJyou mention 
Small-C. Last year I had some experiences with Small C on 
a 6809 and I thought I'd share them with you. 

I have 4 Small-C's. The first two are 6809 Small-C's from the 
C User Group. The third is Byte Magazine's Small-C for MS- 
DOS. The fourth is F. A. Scacchitti's Small-C for CP/M. 

The first one I got was Byte Magazines' MS-DOS Small-C for 
the 8088. It is a fairly 'complete' Small-C and is reasonably 
structured. It has a foirly large standard library. 

The two for the 6809 from the CUG aren't very good. The 
earliest one was CUG 132 and is very old and incomplete. The 
later one is CUG 309. It is a port of CUG 22 1 . It is much better 
but it doan't have a lot of library routines. It does however 
have an optimizer to clean up some of the terrible code that 
Small-C generates. I think there is a bug in the code, but I can't 
remember what. 

I only 'recently' got F. A. Scacchitti's, so I haven't done 
anything with it. 

Most of my experiences with Small-C come from Byte 
Magazine's Small-C. It was more complete than the two 6809 
ones I had and I didn't yet have F. A. Scacchitti's (CUG 222 
& 223). Converting Byte's from MS-DOS 8088 to 6809 0S9 
was reasonably straight forward. (Actually I never finished 
with it. Small-C wasn't complete enough for what I wanted it 
for). Converting the output from 8088 to 6809 wasn't too hard. 
Also there were just a few minor changes for my assembler. I 
also had to change a few things because 6809 0S9 requires the 
program to be non self modifying and Small-C allocated vari- 
ables right into the program section. (I wish all of the stuff that 
needed to be changed was in a single file rather than spread 
throughout the program.) However, the code that was gener- 
ated was terrible. 

At this point I began looking for other compilers. I eventually 
found Dunfield Development in Canada, but their C compiler 
was $50 (including C source) plus $50 for the 6809 generator 



and it had a few limitations as well. It was better than Small- 
C, but not enough to be worth my spending $100. It had code 
generators for several CPU's, including the 6809. The code 
generated though was vastly better. 

1 spent quite some time trying to clean up some of the terrible 
code for the stack but didn't have a great deal of luck. Some 
things went fairly easily, but since I didn't (and don't) have the 
book I wasn't sure about some stuff and I was just blundering 
around in the dark. I also had problems coming up with test 
suites to test my modifications. 

I've been trying for months to talk Microware into releasing 
the source code for their 6809 OS9 C compiler. They stopped 
selling it about 5 years ago, don't support it, and barely admit 
to it's existence. It is a fairly complete compiler, including 
structures. I haven't had any luck though and I don't really 
expect to. It is a multi-part compiler which reduces the memory 
strain for 64k machines. I've examined the disassembly and 
discovered that it was self compiled so it would be possible to 
regenerate the C source code. It would be a LOT of effort 
though. The preprocessor ($27AC), the analyzer ($7B76) and 
the code generator ($6444) sections total to about 64K worth 
of code. That would be a LOT of tedious trial and enor to 
regenerate the C source (I did that with the C library, so I 
know). It also has a couple of bugs that need to be fixed. If 
the source could be obtained it would be a fairly decent general 
compiler. 

I've also tried to track down several others, but with no luck. 
That was why in a previous issue of TCJ I asked if anybody had 
a K&R C compiler. I've received two, but they are fairly large. 
I don't have a modem or I would check CompuServe, BBSs', 
Delphi, etc. Perhaps somebody might be able to talk the 
authors of some of the public domain C compiler's (in 
executables) to release the source code. 

If TCJ does decide to 'sponsor' a C compiler. 1 have a few 
suggestions. 

1 : Before any work is actually done on Small-C again, I think 
it would be a good idea to put out a 'call' on major BBSs', 
CompuServe, computer nets. etc. Looking for a newer compiler 
base to work with. It would have to be very small, but maybe 
at least it would be better organized than Small-C is. It would 
only take a couple of weeks and the results might be substan- 
tial. 

2: If you do decide to standardize on Small-C, you are going 
to have to decide which one. There are a lot of them out there 
and most have been 'extended' in non-portable ways. Also, 
most of them have changes made inside the compiler itself 
(cclx.c-cc3x.c) rather than limiting them to the output part 
cc4x.c. Most of the changes are for assembler compatibihty. 
Some might be tempted to suggest using the version in the 
book, but most don't have the book and would have to buy it 
for $30. I think that particular version in the book has been 
copyrighted so it can't be shared. If you are going to end up 
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spending money, you might as well buy Dunfield's for $50 and 
make your own processor output (it comes with 8088, you have 
to buy others or write your own). 

3: The compiler should output P-Code. That way a single 
compiler can incorporate all improvements for all CPU's. To 
convert from the P-Code to regular ASM would just require a 
simple translator. If you also bracket variables with pcodes 
indicating that it is a variable, that would allow a wide variety 
of formats. If you also indicate beginiung/leaving function then 
you could also easily add custom code in the translator. The 
bracketing of stuff would allow for ROM/RAM (after all, you 
can't put variables in ROM), etc. The translator could also take 
care of the format of labels etc. That would completely separate 
the assembly format and the opcodes from the compiler itself. 
Nice, neat, and generic. Isn't that what you want from a 
portable compiler? The only 'catch' is there is an extra step 
in the compile process; converting the pcodes into assembly. A 
simple shell program would handle that. TCJ could do it sort 
of Uke the FSF does GNU, improvements are regularly incor- 
porated into the master version. That would require somebody 
to maintain it though. All of this would also make cross 
compiling a lot easier. The only problem with pcodes is embed- 
ded assembly instructions in it. Again though, pcodes could 
bracket it and tell the translator about it. At the very least, all 
changes for porting should be limited to CC4x.C and not 
spread throughout the whole compiler, 

4: It might be nice if the compiler was in parts. A preprocessor, 
a tokenizer/parser, and a code generator. The C compiler for 
6809 0S9 is in 3 parts (listed above) and also has an optimizer, 
assembler and linker. Doing things in parts does cause a few 
problems, but it allows it to handle larger programs, more 
symbols, etc. My 0S9 C compiler compiles the Byte Small-C 
to about 29k of code. Small-C compiling itself would be much 
larger. That is less than the individual parts of the full K&R 
C compiler of mine. 

5: It really should be expanded to include multi-dimensional 
arrays, as well as arrays of pointers, unsigned integers, mul- 
tiple levels of indirection pointers, typecasts, sizeofO, etc. Struc- 
tures would be nice (and not quite as hard to implement as may 
be thought), but could be worked around if you have other C 
stuff. The limitations of Small-C are just too great for a person 
to WANT to work with it. Improvements to Small-C would 
have to be made. 

6: A better preprocessor would also be nice. 

7: It is going to HAVE to generate better code than the original 
Z80 CP/M version. I know that it will be used on a Z80 so better 
code would have to be an option. Perhaps a pcode 'optimizer' 
to go through and clean up the stack indexing code for non-Z80 
CPU's. I don't know, but I do know that normal Small-C 
generates such terrible code that most wouldn't want to use it. 
They'd probably get better performance from Forth. 

8: I think that Small-C should be reorganized. That might 



make it much more readable and modifiable. Small-C has a 
serious problem in that it has been upgraded and had features 
added so much that the general structure isn't good. A lot of 
improvement could be made by defining a few labels for the 
expression analyzer indexes. Change a few names of some of 
the routines to make them more self explanatory would also 
help. Reorganize the source into distinct sections, etc. Nothing 
major really all of it could be done with a good word processor 
and a day or two. 

9: There should be some form of register assignment in the 
outputted assembly. What I mean is that the compiler should 
be able to recognize that not all registers are data registers, 
some are address registers. One of the problems with Small-C 
is that it was almost hardwired from the beginning for the 8080 
and its descendants, the Z80 and 8088. When I attempted to 
port it to the 6809 I had some problems because the 6809 has 
one 16 bit data register and 3 address registers. The compiler 
expected the secondary register to be a data register with 
address register capabilities. That caused major problems in 
most operations because I couldn't do math operations or, the 
secondary register because it was an address register. Instead, 
whenever a transfer to the secondary was to be made I pushed 
it onto the stack. That resulted in even worse code and left the 
address registers almost idle. As I said before, the Small-C 
compiler has some MAJOR problems. A replacement should 
be found, or at least major changes to the expression analyzer 
should be made. 

10: There should be some list of all the features of Small-C as 
compared to K&R C. If there is a list of features and abilities 
of each, then people would know what needs to be added or 
changed. As it is, its just 'shooting in the dark'. 

1 1 : the size of the tables should not be fixed at runtime. Instead 
it should dynamically allocate them as needed. That would 
involve a number of changes to the tables, but it would allow 
a more reasonable approach to the 'size' of the programs that 
it can compile. 

To summarize, Small-C would have some major improve- 
ments. If possible, an alternative C compiler should be found. 

If Small-C does have to be used, I'm not sure what base to 
suggest using. Either Byte's or F.A. Scacchitti's. I haven't 
studied FAS's much, but I don't really like the way he did the 
multiple dimension arrays. Of course, I can't say I could do 
better. FAS's and Bytes seem to be the same base. FAS's has 
a few additions and Byte's has more libraries. Byte's is for 
8088 MS-DOS, FAS's is for Z80 CP/M. Flip of the coin 
basically. 

I personally have only one computer, a Tandy Color Computer 
3 w/512K, a single 360K floppy, and 0S9 and its C compiler. 
I can't really judge what would help other computers. The 
operating system is in one 64K bank and each process gets its 
own 64K address space all for itself That allows larger pro- 
grams than other computers that have to have the OS in the 
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same program memory. 

Well, I just thought I'd put in my 2 cents worth. 

Carey Bloodworth. 

P.S. I've managed to learn of the existence of 2 old, portable, 
fairly small K&R C compilers. So far 1 haven't been able to 
actually locate them though. C.B. 

Dear Bill Kibler; 

Greetings. I see in issue #61 you're thinking about Small C, so 
here is a little material in this area: a Small C 68HC11 com- 
piler/assembler. I can't say the 681 1 would be my ideal embed- 
ded processor, but it has its charms.... See README. SCI on 
the diskette for a short description of files, and then there's tons 
of my documentation in there.... 

At any rate, the interesting thing here is probably the source 
files CC4*.C and CALLl I.MAC. These are supposed to be the 
machine-dependent part of the compiler, although 1 won't 
swear there isn't a little stuck somewhere else in the source. 
These are the parts you have to change to adapt the compiler 
to another target. It's not exactly child's play, but it isn't that 
hard - you need to know at least a little C, and be familiar with 
the target, and of course have a test system. 

As for the thing itself, I discuss this in the docs, but it's really 
not the world's most wonderfiil program, at least source-wise. 
This is partly because of the almost total absence of conunents 
(I mean, Hendrix probably created it on 128K diskettes); to this 
day I usually can't figure-out what's going on in there and 
Heaven knows, I've tried. Hendrix or someone apparently 
referred to it as an "educational" compiler, and this stuck, 
leading to years of silly magazine remarks about how it's so 
usefiil for learning how a compiler works. It isn't. What I think 
was meant was that it was good for schools etc., because it was 
cheap/free. Be that as it may, it's still a useful compiler, and 
it is quite feasible to re-target it... 

Language-wise, the most aimoying thing about it is the absence 
of structures Gike Pascal records). Otherwise its restrictions are 
fairly bearable. I'd still Uke to get hold of a decent public 
domain K&R source with structs and everything - but then it 
probably wouldn't fit on my hard drive anyway.... 

Bulletin: On my quest to find a book describing the PC hard- 
ware, I found *one*: *Interfacing to the IBM Personal Com- 
puter*, second edition, by Lewis C. Eggebrecht, $24.95 (1990, 
SAMS). I've shelved my DMA project for a while, so I haven't 
put it to a real test, but it *looks* pretty good. Genuine timing 
diagrams, schematics, register descriptions.... 

J. G. Owen, South Huntington, NY. 

Small C 68HC1I compiler, assembler, (to be found on JW 
Weaver's BBS - SEE page 10 - Support Groups.) 



Thu 07-22-1993. 

This package includes a lot of material, and zip files within zip 

files. It is primarily a 68HC11 product, but includes an 8048 

assembler. 

A good deal of this stuff is derived fi-om products of J.E. 
Hendrix, and he may well own the copyright to them. Various 
documentation herein elaborates on this. As noted, the docu- 
mentation is relatively extensive, including lots of deep thoughts 
about Small C, embedded systems, and other fascinating top- 
ics.... Note however that neither Small C or C language is 
documented in here. 

SCU.ZIP 

sen. DOC describes compiler operation, including 

essays on the meaning of things. 
README.SCl this file. 



SCllSRCZIP 
CC*.C etc. 
SCll.EXE 
GOODBYE.* 
EDIR 



XMACZIP 
MACOP.DOC 

M6811.EXE 

M48.EXE 

LNK.EXE 

BS.EXE 

68HC11.MIT 

48.MIT 



source for 68HC11 Small C (TC 2.0). 

the compiler. 

demonstration project. 

describes some of the files, short history 

/notes on project. 



describes assembler, linker operation, 

with much digression. 

68HC11 assembler. 

8048 assembler. 

linker. 

symbol/file converter. 

op table. 

op table. 



FILES 

Files that should be associated with this documentation: 

MACOP.DOC This document. 

M68 1 1 .EXE 68HC 1 1 assembler. 

M48.EXE 8048 assembler. 

TEST6811.MAC 

TEST6811.LB 

TEST48.MAC 

TEST48.MAC 

T48.BAT 

T68.BAT 

68HC11.MIT 

48.MIT 

LNK.EXE 



Test files. 



Process TEST*.ETC. 



BS.EXE 



Configuration files. 
Linker which is supposed to work with 
bothM6811, M48. 
Link-to-Motorola-S-record translator (for 68HC1 1). 



Note that LIB.EXE, a library program which originally was 
included with the Hendrix Small Mac package, is NOT in- 
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eluded here, because it almost certainly doesn't work anymore 
with the endlessly-hacked XMAC. However, this documenta- 
tion includes some references to the program, and there are 
various switches in the linker which relate to it. The LIB 
program, including the source, can probably still be obtained 
from Dr. Dobbs. 



SUMMARY, fflSTORY 

This document describes the features of an assembler + linker 
currently configured for the 68HC1 1 and 8048 and collectively 
referred to as "XMAC" herein. This is a major hack of J.E. 
Hendrix's Small C configurable assembler MAC, which I 
obtained through Dr. Dobb's magazine offer (see REGISTRA- 
TION, below). The programs described here run on MSDOS 
systems; there used to be CP/M versions, but these have passed 
into the land of STAT and DISK R/0 ERROR. Great quantities 
of this text consist of MAC documentation. 



port equipment is ridiculously expensive (//this was written in 
1987 or so; support equipment since then has become compa- 
rable to that for other microprocessors; not cheap, but not that 
offensive - i.e. $1000 to $10,000). 

Somewhere in the vicinity of this file may be 68HC11.MIT, 
which can provide some guidance as to exactly what syntax I 
had in mind for this device; I was attempting to follow the 
Motorola specification, but note that specifically- Motorola 
conventions are always overthrown for Intel conventions ~ i.e., 
"LDAA #12H", not "LDAA #$12" (actuaUy #$12 probably 
works now). 



BS 



BS is a program that translates the output of LNK into a 
Motorola S-record (i.e., BS, "Binary/S-record", of course). In 
addition, it can create files suitable for downloading to the 
TEC16811 emulator. 



M48 



M48 is the 8048-configured version of XMAC. The 8048 is a 
very common - i.e., readily available, cheap, and therefore 
obsolete ~ single-chip microcomputer originally released by 
Intel but now available from many sources. It is typically used 
as a micro-controller to provide intelligence for keyboards 
(IBM PC keyboards are based on this architecture), printers, 
microwave ovens, etc. The 8748 ~ a 2K, EPROM version of 
the part ~ goes for as low as $8 retail. 

Developing programs for the 8048 family, even with M48 or 
some other assembler, isn't much fim without some develop- 
ment equipment in the $1000 to $???? range. Also, an 8748/ 
49 EPROM burner is necessary for small quantity projects. 
Nevertheless, it is feasible to write simple programs for the 
8748 without debugging equipment, providing intelligence for 
small quantity applications with a start-up cost equal to an 
appropriate EPROM burner. (Honestly, I haven't done it; I 
designed and built an 8048 emulator ~ 1 forget exactly why ~ 
which I then used on a few projects. Designing/building the 
emulator was fun, exciting, and extremely complicated; I had 
to buy a better scope just to debug it. I'm not sure I'd like to 
try an 8048 project without an emulator.) 

See "48.MIT" ~ the assembler configuration table for the 
8048 assembler - for a list of the exact available instruc- 
tions. [1] 

M6811 

M681 1 is the 68HC1 1 version of XMAC. Motorola's 68HC1 Ixx 
is an amazing, HC-CMOS based single-chip microcomputer 
which includes everything AND the kitchen sink (i.e., timer, 
A/D converter, UART, radar-range, etc.). It has a somewhat 
enhanced 6800-type instruction set (actually, 6801), but still 
reflects the tedious hmitations of that architecture (i.e., it's no 
6809). Obtaining documentation may be difficult. Also, sup- 



James Gregor Owen 
Huntington Station, N.Y. 



C USER GROUP 

The Following is information on what the C User Group has 
for the Small-C implementation. The information was re- 
moved from the Small C Users Group CD ROM. 

Important files and directories: 



cug_info.txt 


Info about the C Users Group 


capsule.txt 


Capsule descriptions of each file in 




Volumes 100-299 


catalog.txt 


Catalog of each CUG Library volume 


listings\ 


Source code listings from 




The C Users Journal 


vol 100\ 


CUG Library volumes 100-199 


vol 200\ 


CUG Library volumes 200-299 


vol_300\ 


CUG Library volumes 300-364 


zipped\ 


All the CUG Library volumes compressed 




in zip archives 


bbs\ 


BBS support files 



Can be purchased from: 

The C Users Group 
1601 W. 23rd St. Suite 200 
Lawrence, KS. 66046 
+1-913-841-1631 

Wahiut Creek CDROM 
1547 Palos Verdes Mall, Suite 260 
Wahiut Creek, CA 94596 
1-800-786-9907, +1-510-786-9907 
FAX +1-510-947-1644 
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CUG104 



CUG104.27-C1.C By Mike Bemson, Ron Cain. Small C-Part 
1. Main line and opening text plus #include, #if, #nif, error 
summary! dumping extern, arid static area for a Small C 
compiler. Executable image on disk. ->ASSEMBLE.COM, 
LINK.COM. [CP/M:BDS v. 1.41] This Small C is NOT self- 
compiling and requires special assembler and linker which are 
available ONLY in executable form. 



floating point math. Executable image is included so that 
compiler is self-compiling. Produces relocatable assembly for 
ZMAC & ZLINK (also on the disk). ->CUG104, CUG115, 
CUG132, CUG146, CUG163. [CP/M:Self compiUng] 

CUG156.10-CC.DOC C Compiler Documentation. Documen- 
tation for the z80 Small C Compiler with floating point math. 
->C80V.C. [CP/M: Self compiUng] 



CUG163 - 



CUG132- 



This file covers the 6809 implementation of Ron Cain's Small 
C compiler and a graphics driver/support package for the 
Radio Shack Color Computer. 

To make it: 

You must have a functioning version of BDS C on drive A. 
Move the submit file bldc.sub onto drive A with this disk in 
drive B. Submit bide. If all goes without error, you will need 
to answer the questions at the end of the link phase as to which 
files must be searched. Input canew in response to the first 
question, cb to the second, . „ , ce6809 to the fourth and the link 
should complete leaving canew.com on drive B. You will 
probably need double density drives (1/2 meg) to build on drive 
b or will have to shuffle the compilation and link operations. 



cue 146 



CUG146.11-SMALLC.C v 2.0 By Serge Stepanoff, Ron Cain. 
Small C compiler for 6800. A version of Ron Cain's Small-C 
adapted for the 6800 micro under TSC's FLEX operating 
system. Initial conversion was done on a PDP 1 1 running RSX- 
1 1 and the DECUS (public domain) C compiler with Small C 
code from DECUS. Ongoing development of this version is 
being carried out on a SWTPC 6800 with dual 8 inch floppies 
and 32K RAM. [Flex v. 2.1:Small C] The TSC assembler 
accepts say length labels but only the first 6 characters are used 
and saved in the symbol table. Therefore, if you have either 
fimctions or labels of the type MODULEl and M0DULE2, the 
assembler will generate a multiply defmed label error. Make 
sure that the first 6 characters are unique. 



CUG156 



CUG156.08-C80V.C v. 1.2 By Ron Cain, James Van Zandt. 
Small C Compiler with Floats. z80 Small C Compiler with 



CUG163.01-CC11.C By J. Hendrix, Daniel R. Hicks. Small C 
v. 2. Small C Compiler by J. Hendrix adapted to MSDOS 
environment. [MSDOS: Small C] 



CUG200 



SCI - Small C Interpreter 

This Small C interpreter by Robert Brodt (NJ) is a shareware 
package available only as an executable image for PC-Clones 
and is accompanied by two extensive documentation files. A 
useful learning aid. [share2] 

CUG200.05-SCI.EXE 1.5 executable 

Small C Interpreter. By Bob Brodt. A small C interpreter, 

designed to introduce C. Includes a screen editor, & debugger. 

=> USER.MAN PROG.MAN. [MSDOS:] Requires 64K of 

memory. 

CUG200.06-SHELL.SCI 1.5 source 

By Bob Brodt. The command shell, written in SCl's dialect of 

C. => USER.MAN. 

CUG200.07-USER.MAN doc 

Small C Tutorial. By Bob Brodt. SCI users manual describing 

shell, editor, language, library functions and dd)ugger. => 

PROGRAM.MAN. 



CUG221 



6809 C For Flex 

A rewrite of Ron Cain's Small C targeted for 6809 processors 
running under the FLEX operating System. Dieter Flunker 
(Italy), has expanded slightly on the language subset imple- 
mented by Cain and includes a peephole code optimizer, [pub- 
lic] 

CUG221.07-CC1 TO CC91 2.3 source 

SmaU-C compiler for 6809 FLEX By Pieter H. Flunkert, Ron 

Cain. Small-C compiler which produces 6809 assembler out- 
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put. This volume includes both C source and compiled output 
(as optimized assembly source). 6809 FLEX: VAX VMS C. 
Requires TSC relocatable assembler, library generator and 
linking loader. 



CUG221.35-README.DOC doc 
Documentation of the disk contents 



CUG222 



Small C for CP/M Doc and Exec 

F. A. Scacchitti's (NY) significantly enhanced version of J.E. 
Hendrix's Small C v2.1. This CP/M implementation handles 
global initialization, external statics, the ternary conditional 
operator, multiple levels of indirection, global multi-dimen- 
sional arrays, arrays of pointer, hex and octal constants, and 
nested includes. Also includes an expanded standard library. 
Contains the executable COM file, relocatable libraries and 
user documentation. Source is on CUG223. [public] 



CUG223 - 



Small C for CP/M Source The source code for a Small C 
compiler. A fiiU description appears with the entiy for CUG222. 
To construct the compiler you must have an M80 compatible 
assembler, [public] 

CUG223.02-ABS.C source 

By F. A. Scacchitti, Returns the absolute value of an integer. => 

CUG 222. [CP/M: Small C] 

CUG223.139-ZZBUF.MAC source 

By F. A. Scacchitti. Used to preserve standard CP/M buffer for 

input arguments. [CP/M: M80] 

CUG223.140-ZZFIO.MAC source 

By F.A. Scacchitti. File 1/0 storage variables. [CP/M:] 

This disk contains a total of 140 Source files! 



CUG309- 

README.DOC for CC09 MSDOS C COMPILER 

Brian Brown, Senior Lecturer, Software Engineering, Central Insti- 
tute of Technology, School of Electronic Engineering, Private Bag, 
Trentham, Upper-Hutt, Wellingon, New Zealand 

15th November 1989 

The Small C Compiler for 6809 running on FLEX (CUG 221) has 
been ported to MSDOS, and changed to allow creation of embedded 



target software. It supports the ASxxx group of assemblers (CUG 
292) available from the C users Group, as well as the Motorola AS9 
assembler. 

A host of routines is supplied. These work with particular boards 
used by our students. The system we have is, 

6809 Processor card, 32k StaticRAM 0000 to 7FFF. Addresses 
9000-93fr are port mapped to 000 to 3ff for PC type boards. Ad- 
dresses 8000 to SflTare mapped to BOOOO for PC monochrome cards. 
On board ACIA, MC6850 at AOOO (ControlReg) AOOl (DataReg). 
OnBoard EPROM or StaticRAM COOO to FFFF 

The processor card drives an IBM- PC backplane with four expansion 
sockets, thus can talk directly to standard PC cards. The routines for 
this board are ACIA.H, MEMORY.H, STRINGS.H 

Standard PC Serial Card (SERIAL.H) 

Standard Hercs/Monochrome card (HERCS.H, PRINTER.H) 

32bit Digital 1/0 card, plus 8 channel A/D (0808 chip). The mapping 

arrangment of this board is, 

Port 220h A/D Channel register 

Port 22 Ih A/D Data register 

222h A/D End Of Conversion signal 

223h Simple latched I/O 

224h 8255 PPI Port A 

225h 8255 PPI Port B 

226h 8255 PPI Port C 

227h Intel 8255 PPI control register 

In conjunction with this board, a panel comprising, 

1 X 7 segment display 

1 X 8 LEDS 

1 X 8 Digital Switches 

1x16 hexidecimal keypad 

is used to allow students to write software routines. (DIOBOARD.H, 

MCRDRV.H) A magnetic card swipe reader attaches to port C of the 

DIOBoard. 

The DIOBoards address is configurable via DIP, and the A/D con- 
vertor can be: 

- strapped for auto restart, EOC signal restarts ADC 

- software polled via EOC bit status 

- Interrupt driven, by staps which connect EOC to IRQ2 to IRQ7 

The POD SOFTWARE is a simple board MC6821 which has a 
40PIN DIP which plugs across the 6809 target processor. By writing 
to the MC6821 (which connects to DIOBoard) and setting certain 
pins, it is possible to alter the processor state (ie, RESET, HALT) 
and perforai READ/WRITE cycles (by emulating bus cycles assert- 
ing pins mapped to processors pins in correct sequence). 

All the available items are available from us at reasonable cost, eg, 
US funds. We are also currently working on MC68000 and i8051 
processor boards. 

IF YOU RE-COMPILE THE SOURCE, USE A MEDIUM MEMORY 
MODEL!! AND TURN OFF WARNINGS 

* Please note these disks have many more files than Usted. *** 

* Only shown are samples of the data to indicate content. ** 

^i^^i4^ilf4^f:^ii^:^iHli^!tt^^l^*1^^:i|L^i^a^^^t ************************* 
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special Feature 

Intermediate Users 

Part 4 



MOVING FORTH 

by Brad Rodriguez 



Part 4: Assemble or Metacompile? 

"Keep it SHORT!" was the editorial directive for this install- 
ment. So I apologize for postponing the source listings to yet 
another issue. In the meantime, there is a new decision to 
contemplate: 

How do you build a Forth system for the Very First Time? 

You know now that most Forth code is high-level "threads," 
usually compiled as just a series of addresses. In the early days 
of fig-Forth, assemblers were often the only programming tools 
available. This was fine for writing Forth CODE words, but 
high-level threads had to be written as a series of DW direc- 
tives. For example, the Forth word 

: MAX ( n n - n) OVER OVER < IF SWAP THEN DROP ; 

would be written [TAL80] 

DW OVER,OVER,LESS,ZBRAN 
DW MAX2-$ 
DWSWAP 
MAX2: DW DROP.SEMIS 

Later, as working Forth systems became widespread, 
Forthwrights began modifying the Forth compilers into cross- 
compilers [CAS80]. Thus with Forth on your CP/M machine 
(or Apple II, or whatever), you could write Forth programs for 
some other CPU... up to and including an entirely new Forth 
system for that CPU. 

Because they create a new Forth from within Forth, these are 
often called metacompilers. Computer science purists object to 
this, so some Forthies use the terms "cross-compiler" and 
"recompiler." The difference is that a recompiler can only 
generate a new Forth for the same CPU. 

Most PC Forths are now produced with metacompilers, but 
opinion is divided in the embedded systems arena 
[TIN9I,ROD91,SER91]. The arguments for using assemblers 
to write Forth are: 

1. Metacompilers are cryptic and hard to understand, and you 
must thoroughly understand a metacompiler in order to use it. 

2. Assemblers are understood by the average programmer. 

3. An assembler is almost always available for a new CPU. 



4. Assemblers handle many optimizations (e.g. short vs. long 
branch). 

5. Assemblers handle forward references and peculiar address 
modes; many metacompilers don't. 

6. Assemblers use familiar editing and debugging tools. 

7. The code generation is completely visible ~ nothing is 
"hidden" from the programmer. 

8. It's easier to tweak the Forth model, since many design 
decisions affect the internals of a metacompiler. 

The arguments for metacompilers: 

1. You write "normal" looking Forth code, which is easier to 
read and dd)ug. 

2. Once you understand your metacompiler, you can port it 
easily to new CPUs. 

3. The only tool you need to acquire is a Forth for your 
computer. 

The last is particularly applicable to those who don't own PCs, 
since most cross-assemblers require PCs or workstations these 
days. 

I've written several Forths each way, so I'm painfiiUy aware of 
the tradeoffs. I admit a preference for metacompilers: I find the 
Forth code for MAX much easier to read and understand than 
its assembler equivalent. Most of the arguments against 
metacompilers have been overcome by modem ' 'professional" 
compilers, and if you're using Forth for work I strongly recom- 
mend investing in a commercial product. Alas, pubUc-domain 
metacompilers (including my own) are still behind the times, 
clunky, and arcane. 

So I'm going to take a radical position for a Forth programmer, 
and tell you to choose for yourself I'll publish the 6809 code 
in metacompiler form, and I'll supply a metacompiler for F83 
(IBM PC, CP/M, or Atari ST) [ROD92]. The Z80 code will 
be written for a CP/M assembler. The 8051 code will be 
written for a public-domain PC cross-assembler. 

Forth in C? 

No discussion of this topic would be complete without men- 
tioning a new trend: Forths written in C. These have the 



48 



The Computer Journal / #64 



advantage of being more portable than assembler - in theory, 
all you have to do is recompile the same source code for any 
CPU. The disadvantages: 

1. Less flexibility in the design decisions; e.g., direct-threaded- 
code is probably not possible, and you can't optimize register 
assignments. 

2. You have to recompile the C source to add new primitives. 

3. Forth words carry the C call-and-retum overhead. 

4. Some C Forths use inefficient threading techniques, e.g. a 
CASE statement. 

5. Most C compilers produce less efficient code than a good 
assembly-language programmer. 

But for Unix systems and RISC workstations, which frown 
upon assembler, this may be the only way to get a Forth up and 
ruiming. The most complete and widely used of the public- 
domain C Forths is TILE (T1LE_2 l.ZIP, file #2263 on GEnie's 
Forth Roundtable). If you're not running Unix, you should 
look instead at the Genie files HENCE4TH_1.2.A (#2490) and 
CFORTHU.ARC (#2079). 

To continue the previous comparison, here's the definition of 
MAX from HENCE4TH [MIS90] . I omit the dictionary head- 
ers for clarity: 

_max() { 

OVER OVER LESS IF SWAP ENDIF DROP } 

Instead of assembler, C is used to write the CODE words in the 
kernel. For example, here is HENCE4TH's SWAP: 

_swapO { 

register cell i = *(dsp); 

*(dsp) = *(dsp + 1); 

♦(dsp + 1) = i; 

} 

(Please note: there is quite a variety of techniques for writing 



Forth words in C, so these words may appear radically different 
in CFORTH or TILE.) 

On a 68000 or SPARC, this might produce quite good code. 
On a Z80 or 8051, quite the opposite. But even if you plan to 
write a Forth in C, you need to understand how Forth works in 
assembler. So stay tuned for the next installment of Moving 
Forth! 
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THE SCROUNGEMASTER II 



Interested in a printcd-circuit board for the 6809 multipro- 
cessor? I've been exchanging email with TCJ reader An- 
drew Houghton, who wants to build a "Poor Man's 
Transputer" out of the 6809. This prompted some improve- 
ment and expansion of the original ScroungeMaster I design. 
Namely: 

a) four RS-485 serial ports using two Z8530s, instead of the 
2681 

b) two parallel I/O ports, using a 6522 

c) memory mapping logic for expanded memory: 32K on 
board PROM, 32K or 128Kon-board RAM, and 384Kof off- 
board (bus) address space 



The driving principle is still Cheap Parts: I figure the in- 
creased cost of ICs over the ScroungeMaster I is about $9 
(Jameco prices). No PALs. 

Wire-wrapping one of these boards is enough of a headache 
~ I'd like to avoid wire-wrapping three more. If we can get 
commitments for twenty boards, I'll do the PCB layout and 
get boards fabricated at a local vendor. If interested, send me 
GEnie mail (B.R0DRIGUEZ2), Internet email 
(b.rodriguez2@genie.geis.com), or drop a postcard to Brad 
Rodriguez, Box 77, McMaster University, 1280 Main Street 
West, Hamilton, Ontario L8S ICO Canada. 
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TCJ CLASSIFIED 



WANTED: info, on the BRD Inc. com- 
puters DOLPHIN-78 or PORPOISE-78, 
a.k.a. FDC-78 (6800 based machines). 
Also, I need an Apple lie emulation disk 
for my 256K Apple III (I have the Aplle 
11+ emulation disk). Roger Olson, 2304 
West 4th, North Platte NE 69101. 

For Sale: 

KayPro 4-all stock as orginally made. 
System disk, WordStar 3.3, and some 
other software. Printer cable. No manu- 
als available. Works fine! Asking $50 

Kaypro 2X- Advent TuiboRom and drive 
decoder board added; now has two HD 
drives (96TPI) and one DD drive 
(48TPI). Advent system disk, utilities, 
and docs-on-disk, WordStar 3.3, etc., 
manuals and one-piece cover. Runs great! 
Asking $75. 

Kaypro 1 -(last model made) Advent 
TurboRom and drive decoder board 
added; has one DD (48TPI) drive and 
one HD (96TPI) drive; also Minnie 
Winnie 20 meg external drive (the ST- 
506 drive sold by Advanced Concepts 
and Engineering). Loads of software- 
running NZCOM, all the Z-system utili- 
ties, programming stuff, WordStar 4.0, 
3.3, CalcStar, DataStar, and ReportStar, 
and more ~ proably 7 to 10 megs of 
stuflF. Manuals, one-piece cover, etc. in- 
cluded. A really nice machine! Asking 
$200. 

Kaypro printer (Juki 6100 daisywheel) 
and Tractor Feed - with cable. Works 
fine! Asking $60. 

Kaypro Technical manual - in 3-nng 
binder. $10. 

Shipping extra, Contact: Dave Templin, 
2978 Spruce Way, West Saaamento, CA 
95691, (916) 371-2964. 



For Sale: Collector's Guide to Personal 
Computers and Pocket Calculators. 

Prices and illustations included. 36 pages, 
$14.95 plus $2.00 shipping. Fred 
Hartfield, Box 52466, New Orleans, LA 
70152. Digitial Cottage BBS (504) 897- 
5514, help, support, sales, of old sys- 
tems. 

Avaialble: Legal copies of CP/M, 
Boriand Software (Tuibo Pascal, DBase 
II, and more). Many bootable CP/M disks 
formats avaialble. Disk copying, most 
formats inculding Apple CP/M. Manu- 
als and more! Lambda Software PubUsh- 
ing, 149 West Hilliard Lane, Eugene, 
OR 97404-3057, (503) 688-3563. 



NEW CLASSIFIED RATES! 
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Computer Corner 

By Bill Kibler 



Regular Feature 

Editorial Comment 

History and Changes 



I have three items for this comer and for 
a change some space to cover the items 
in. Thanks Brad for keeping it shorter! 
It really has been nice that TCTs writers 
have been so prolific these days, but 
unfortunately it meant I (or my column) 
suffered. Lets see if I can make up for it. 

Stan Veit 

Several weeks ago I received a call from 
Stan Veit. For those who don't know 
Stan, he was instrumental in taking 
Computer Shopper from a small classi- 
fied monthly and making it the worlds 
largest computer and advertising maga- 
zine. I have since found out, Stan's back- 
ground is considerably more involved 
with classic computers than that. 

It seems Stan was the First owner/man- 
ager of a computer store in New York 
city. Since only one other store existed 
in Los Angeles at the time, these two 
owners had lots of first hand knowledge 
about the computer industries starting 
days, which they shared with each other. 

Stan wrote about these early days while 
heingedatOT of Computer Shopper. Those 
columns are now in a book called, ' ' Stan 
Veit's History of The Personal Com- 
puter' ', pubUshed by WorldComm Press, 
65 Macedonia Rd., Alexander, NC 
28701,(704)252-9515. 

My only complaint about the book has to 
do with the original column format. My 
writers should all get this book, as it 
shows a good column writing style and 
Stan does a good job of making sxu°e all 
the facts are repeated every issue as 
needed. That repeating however gets a 
bit annoying in the book. I would rather 
Stan had had the time to re-write some 



it and take the sections that repeat pre- 
vious discussions and expand them or 
include them in previous sections. This 
is something I will be keeping in mind 
if we ever publish TCTs columns in a 
book. 

Stan's personal involvement comes 
across excellently in the book. He is a 
good writer and his experiences are well 
illustrated in the book in both words and 
pictures. I found the book a great source 
of which companies made which sys- 
tems. His personal introductions of people 
that are now very famous gives you an 
insight into their humble beginning. Steve 
Jobs getting his jeans sewed up by Stan's 
mother-in-law is but one sample of in- 
sight and humor combined. 

For anyone who is serious about collect- 
ing and using older systems, the book is 
an absolute must. My only hope is that 
Stan decides to write more about those 
early days. Since each chapter is one 
coliunns worth, I am sure he had lots 
more to say about each company and 
their products. What about it Stan, a 
book for each major product? I can see 
it now, Stan Veit's history of the S-100 
computers. Or.. "Apple: from torn jeans 
to three piece suits, in one year!" 

Changes At TCJ] 

If you are subscribers oi Computer Craft, 
you will by now know that they are chang- 
ing their name to be more Uke our's 
(Microcomputer Journal). They also are 
dropping any support for older PC/XT 
platforms. The Computer Journal's read- 
ers are mostly eight bit system users, but 
many of you have been a bit upset that 
we have not supported the early PC clone 
models. I have stated since taking over 



that I felt others were providing support 
for the PC/XT platforms. 

Since Computer Craft is no longer sup- 
porting them, and their used price is 
now below $ 100 for used mother boards, 
1 feel my previous position is no longer 
vaUd. My main concern, and I am sure 
the concern of most readers, is that TCJ 
does not go the way of other magazines 
and start phasing out all other system 
support. To make siu-e that doesn't hap- 
pen, I am selecting one author to provide 
PC/XT support. 

Out of the ten TCJ regular writing staff, 
having one provide support is allocating 
only 10% to the cause. That leaves all 
the other writers to cover their regular 
beats. This will also make our regulars 
feel better when they provide not only 
their normal support but show how it 
relates to the PC platforms as well. 

I do not have a commitment from Frank 
Sergeant, but I am trying to get him as 
our first PC suRwrt person. Frank cer- 
tainly has the credentials, wants to help 
the magazine, and is well known by 
most of you for his excellent program 
PYGMY Forth. Some ideas I plan on 
explaining to Frank, are: porting 
PYGMY to ROM on a PC; building 
embedded controllers using PC/XT 
boards; serial communications on a PC/ 
XT using the keyboard port; and 6809 
(as in COCO design) or Z180/ZCPR ex- 
pansion boards. 

His first assignments if he agrees to the 
task at hand, will be explaining the PC/ 
XT architecture for those who have not 
been previously indoctrinated. I dare say 
that many users have little true under- 
standing of the PC/XT hardware designs, 
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and thus don't know why so many of us 
at TCJ hate the hardware with a passion. 
I have spent the last three years working 
with 68000 boards that reside as expan- 
sion boards on PC based platforms. The 
68000 side has always been easy and 
straight forward, the PC side anything 
but, which another way of s^ng Frank 
will have his work cut out for him. 

This move should also help our readers 
find platforms for new projects. The flood 
of passed over PC/XT designs and ex- 
pansion products is becoming enormous. 
Vendors are starting to practically give 
them away. They are looking for places 
to advertise not only these older PC items, 
but a few old Z80 or 6809 based items as 
well. With our past position on no offi- 
cial support, these advertiser were pass- 
ing us by. No more! 

New Advertising Strategy 

The Computer Journal has been doing 
well for the last year. Although not run- 
ning in the red, we are not making money 
either. We need advertisers to make the 
difference. Our readers are also com- 
plaining constantly that they can not fmd 
support or products to meet their needs. 
Our advertising rates were reflective of 
days gone by. All this has come to indi- 
cate time is right to lower om rates. And 
lower we have. 

Effective with this issue, we are drop- 
ping back our rates in hopes that many 
of the mom-pop type vendors can start 
advertising and providing the reader with 
sources to meet their needs. How much 
of a drop, does 70% DROP sound about 
right. See page 50 for a complete revised 
rate card. 

The major idea with this reduction is to 
give our readers names and address of 
vendors who have products they are look- 
ingfor. David Klink's letter in our Reader 
To Reader section is typical of our 
reader's problems. David would like to 
build something using the new Motorola 
68306 but is at a loss to fine one. 1 could 



call our local Motorola rep and get one, 
but one doesn't help our readers. 

Since spending so much of my time doing 
the magazine, 1 have lost contact with 
many vendors that provided small quan- 
tity sources of products. Hopefully they 
will see the changes in our rates and 
reconsider about advertising with TCJ. 

WHAT NEXT? 

Now that The Computer Journal is mov- 
ing to PC based platforms, I guess 1 can 
admit that I am working on OS/2 doing 
C programming. The move was some- 
what of my employers choice, but I did 
agree to it. The upshot of these changes 
is that 1 have become familiar with OS/ 
2 in considerably more detail than most. 
Our company has had a single product 
on OS/2 for some time now. It has had 
poor acceptance by our users. The pro- 
grammers have had more problems with 
their tools than they want to think about. 
It is getting better however. 

The biggest surprise 1 have had is in 
finding books to support OS/2. There 
are so little it is amazing the product is 
being used at all. In one major book 
store chain, the Windows section is many 
feet in length. The OS/2 books however, 
fill about 10 to 12 inches of space. The 
new Windows NT section is already 
longer than OS/2 and the product has 
only been out a few weeks. 

I must admit to finding a few good books 
and will discuss them next time. I think 
there are two reasons for the shortage, 
one is just lack of OS/2 sales, the other 
is OS/2's compatibility with DOS. So 
much of how OS/2 works is Uke PCDOS 
and thus many users have not decided to 
look deeper into the system. For pro- 
grammers, IBM's own series of RED 
BOOKS is quite good and complemented 
by ON-LINE support, such that using 
outside books may be a thing of the past. 

The most distaibing thing is actually 
stepping back in time again. The CP/M 
world has many usefiil utihties that have 
never made it to the MSDOS world. It 
has always amazed me how users can 



talk about how great MSDOS is yet the 
advanced tools and utilities that I came 
to love in the CP/M world have no equiva- 
lent. The worse part is the users have 
little understanding of their loss, but 
instead just work around the problems 
or make their own crude tools to do the 
job. 

Well for new users to OS/2 welcome 
back to the dark ages. Some MSDOS 
tools have been ported, but in many cases 
only half heartedly. As time moves on I 
hope this situation will change. OS/2 2. 1 
is a very impressive platform and as 
such deserves better press and support. I 
hope to explain that position next time. 

Now when talking about programming, 

1 expanded a simple main.c file with all 
the listing options turned on. That means 
all the included and header files would 
be printed out in the listing. Well my 
35K source file became 6,750K long! 
That means over 6 megs of data was 
included during the assembly process. 
Try assembling one of these OS/2 C 
modules on a small memory machine. 
Our machines now have 16 Megs of 
memory and 350 MByte hard drives as 
minimum setup. 

Speaking of drives, it will take at least 
100 megs of hard drive for the system 
and a few programs. The manual says 
you can squeeze it onto a 60 meg drive, 
but don't try. Now I do imderstand that 
Windows NT is about twice as big as 
OS/2, so if you really want to wing it up 
to the big time, up might go an NT it.. 

The main problem you will face if you 
try a small disk, is swap space. The OS/ 

2 system uses virtual memory, which 
means programs (many programs) can 
share the same memory space. The sys- 
tem just moves parts of the program out 
onto disk when not being used. Like 
when I was compling the 6 megs. I as- 
sume that at least half of that ended up 
temporarily on disk 

Oh well more next time... and... 

Welcome to the ever improving The 
Computer Journal. Have tiin hacking... 
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